> ## Documentation Index
> Fetch the complete documentation index at: https://vida.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Agents through the API

> Understand Agent accounts, configurations, discovery, staging, and publishing.

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.

## Recommended workflow

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](/docs/api-reference/agent-guides/configuration-lifecycle) for exact staging, version, experiment, and publish behavior.

<Note>
  The pages in this section explain multi-step API workflows. The generated endpoint pages remain the source of truth for request and response schemas.
</Note>

If an AI agent will perform these workflows, install or reference the [Vida API Skill](/docs/api-reference/vida-api-skill).