Create agent
Create a new agent
Authorizations
API key for authentication
Body
1 - 100Required on create, along with languageId, voiceId and
basePrompt inside it.
ACTIVE, INACTIVE, SUSPENDED Spoken verbatim immediately before a corpus search, to cover the lookup pause. Written in the agent's own language — it is not translated.
300Action IDs to attach.
Knowledge base IDs to attach.
Corpus IDs to attach. Each becomes a search_{name} tool on the
agent automatically — no tool configuration required.
A chat knowledge base to assign.
Response
Agent created successfully
An agent as returned by the API.
Note the asymmetry with the create/update payloads: you write
configuration under config, and read it back under
standardConfig (or customProvider). The type field tells you which
one is present.
Only ACTIVE agents accept calls.
ACTIVE, INACTIVE, SUSPENDED standard agents carry standardConfig. custom agents use
caller-supplied STT/LLM/TTS providers and carry customProvider.
standard, custom The workspace this agent belongs to.
Present when type is standard.
Actions attached to this agent.
Knowledge bases attached to this agent.