Agents & teams
The people — and the AI — who answer conversations.
Scope: agents_teams
⚠️ Creating an agent can charge the card on file. A human or AI agent
occupies a seat; if the plan has none free, a prorated charge is taken.
A 402 with code: seat_charge_failed means nothing was created and a
retry is safe.
List agents
Every agent in the account, human and AI, with their role. The `id` here is what goes in `assignee_id` on a conversation and in the SSO agent allowlist.
Create a human agent
Create a human agent.
Get an agent
Get an agent
Update an agent
Update an agent's profile, role or activation state.
Deactivate an agent
Deactivate an agent.
List AI agents
AI agent profiles, with every setting they carry. `agent_id` is the agent record each one fronts — that is what you assign a conversation to.
Create an AI agent
Create an AI agent. ⚠️ **This may charge the card on file** — an AI agent costs
Get an AI agent
Get an AI agent
Update an AI agent
Only the fields you send change.
Delete an AI agent
Deletes the AI profile and deactivates the agent record fronting it. Conversations it handled keep their history; the seat is released at the next billing cycle.
List teams
Every team in the account. `?include=members` adds each team's roster.
Create a team
Create a team.
Get a team
One team, with its members resolved.
Update a team
Only the fields you send change. Sending `agent_ids` replaces the whole roster.
Delete a team
Conversations still assigned to the team are detached and return to the general waiting line rather than becoming unreachable. The response says how many.
List roles
The roles defined in this account, for use as `role_id` when creating or