Agents

Agents are your voice and chat assistants. You build and configure them in the dashboard; the API lets you list them and manage which client each one belongs to.

List agents

Returns every agent in your agency, newest first.

GET /agents

curl https://intent-weasel-655.eu-west-1.convex.site/api/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

data

array

Show agent

string

The agent’s unique id (use this in other endpoints).

name

string

The agent’s name.

clientId

string | null

The client this agent is assigned to, or null if unassigned.

type

string

voice or chat.

providerAgentId

string

The underlying voice-provider agent id (used to correlate conversations).

createdAt

string

ISO 8601 creation timestamp.

{
  "data": [
    {
      "id": "jd70...",
      "name": "Front desk",
      "clientId": "ks70...",
      "type": "voice",
      "providerAgentId": "agent_7901...",
      "createdAt": "2026-06-19T14:00:38.233Z"
    }
  ]
}

Get an agent

GET /agents/{id}

string

required

The agent id.

Returns the same shape as one item in the list above, or 404 if the agent isn’t in your workspace.

curl https://intent-weasel-655.eu-west-1.convex.site/api/v1/agents/jd70... \
  -H "Authorization: Bearer YOUR_API_KEY"

Assign an agent to a client

Requires the Scale plan (write access).

Assigns, reassigns, or unassigns an agent. Pass a clientId to assign it to that client, or null to unassign it.

PATCH /agents/{id}

string

required

The agent id.

clientId

string | null

required

The client to assign the agent to, or null to unassign. The client must belong to your agency.

curl -X PATCH https://intent-weasel-655.eu-west-1.convex.site/api/v1/agents/jd70... \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "clientId": "ks70..." }'

{
  "id": "jd70...",
  "name": "Front desk",
  "clientId": "ks70...",
  "type": "voice",
  "providerAgentId": "agent_7901...",
  "createdAt": "2026-06-19T14:00:38.233Z"
}

Reassigning an agent only moves the agent — its past conversations, knowledge base, and phone numbers stay recorded under the client they were created in.

Getting started

Your brand

Clients

Building agents

Chat & embedding

Calendar

API

Billing your clients

Account & billing

List agents

Get an agent

Assign an agent to a client

​List agents

​Get an agent

​Assign an agent to a client

List agents

Get an agent

Assign an agent to a client