Create a voice agent
Create a voice agent with its prompt. Optionally set prompt, voice and
knowledge-base values in the same request; they are validated exactly as in the settings
endpoints and the whole request fails if any value is rejected. Add tools afterwards with
POST /api/v2/tools using the returned id as agent_id.
Autorisierungen
Scoped API token. Required scopes are listed on each operation in x-required-scopes.
Body
Flat JSON object. Unknown top-level keys are ignored. The nested sections are validated exactly as
in the settings endpoints; if any value is rejected, nothing is created (HTTP 422). A tools key
is rejected: create and enable tools with the Tools endpoints after the agent exists.
Display name of the agent.
1Free-text description shown in the dashboard.
Prompt settings. Keys may also be given in dotted form (prompts.user_prompt). Unknown keys return 422.
Dotted voice settings keys as listed by GET /api/v1/voice_agents/{id}/concerns/voice_config/schema, for example voice_config.response_time_ms. Unknown keys return 422.
Knowledge sources to attach to the agent's prompt.
Antwort
The created voice agent.
ID of the voice agent.
Display name of the agent.
Empty string when no description is set.
When the agent was created.
When the agent or its prompt was last changed.
URLs of this agent's settings endpoints.