Skip to main content
Vida separates the account that owns an Agent from the configuration records that describe its behavior.
  • targetAccountId identifies the stable Vida account that owns the Agent.
  • agentConfigId identifies a staging, live, or saved Agent configuration. Staging and live configurations have different IDs.
  • versionId identifies a saved configuration snapshot used for rollback or experiments.
Use targetAccountId to scope account-aware requests. Obtain configuration IDs from Agent reads rather than treating them as account IDs.
  1. Read the selected account’s staging configuration.
  2. Discover account-supported models, voices, functions, and apps.
  3. Update only the writable settings you intend to change.
  4. Read staging again and verify the complete result.
  5. Test the staged Agent.
  6. Optionally save a named version.
  7. Publish staging.
  8. Read the live configuration and verify it independently.
Continue with Configuration lifecycle for exact staging, version, experiment, and publish behavior.
The pages in this section explain multi-step API workflows. The generated endpoint pages remain the source of truth for request and response schemas.
If an AI agent will perform these workflows, install or reference the Vida API Skill.