Create an agent from a template

Create a voice agent from a template. Every requirement the template declares must be bound to one of your own resources, unless it is marked optional — an unbound optional requirement drops the tools that needed it. Settings your organization cannot use (a model whose vendor integration is not connected, an ElevenLabs voice without the ElevenLabs integration) are substituted for ones it can, and every substitution is reported in the response. Deciding that needs your organization's integration status, so if that cannot be read the agent is not created at all — retry the call rather than accepting a configuration chosen without it.

The agent is created as a draft, exactly as POST /v1/agent-media/agents creates one: the bound configuration is written to version 0.1, no publishedVersion is set, and the agent answers no calls until you publish with POST /v1/agent-media/agents/{agentId}/versions/{version}/publish. Edit it first if you want to — a draft is editable in place with PUT /v1/agent-media/agents/{agentId}/versions/0.1, which a published version is not. PUT /v1/agent-media/agents/{agentId} will not accept a configuration for it in either state.

Path Parameters

Response Body