Skip to main content
An agent is the unit of configuration for a voice conversation. It owns:
  • A name the team uses to identify it.
  • A system prompt that steers the underlying LLM.
  • An organization that scopes who can see and edit it.
  • A creator — the user who first created it.
Agents are mutable: you can rename them, edit the system prompt (via the web UI’s draft flow), and duplicate them. Deleting an agent cascades to any conversations that referenced it.

​
Lifecycle

​
Scope rules

All agent endpoints are organization-scoped. The endpoints read the requester’s active organization from the session and only return agents that belong to it. Cross-tenant lookups return 404 agent_not_found — there is no enumeration distinction between “wrong org” and “doesn’t exist.”