List Agents
Retrieve all agents for the authenticated user.
GET
/v2/agentsList all agents owned by the authenticated user.
Query Parameters
Max results to return
Pagination offset
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | integer | 50 | Maximum number of agents to return (1–100) |
offset | integer | 0 | Number of agents to skip for pagination |
Response 200
{
"agents": [
{
"id": "ag_c47e7c97_b2f2",
"name": "Sales Agent",
"model": "gpt-4o",
"agentType": "simple",
"voiceEnabled": false,
"createdAt": "2026-03-07T10:00:00Z"
},
{
"id": "ag_d58f8d08_c3g3",
"name": "Phone Support",
"model": "claude-3-5-sonnet-20241022",
"agentType": "simple",
"voiceEnabled": true,
"createdAt": "2026-03-06T08:30:00Z"
},
{
"id": "ag_e69g9e19_d4h4",
"name": "Order Workflow",
"model": "gpt-4o",
"agentType": "graph",
"voiceEnabled": false,
"createdAt": "2026-03-05T14:15:00Z"
}
],
"total": 3
}Response Fields
| Field | Type | Description |
|---|---|---|
agents | array | List of agent summaries |
agents[].id | string | Agent public ID (format: ag_*) |
agents[].name | string | Agent display name |
agents[].model | string | LLM model identifier |
agents[].agentType | string | simple, graph, or workflow |
agents[].voiceEnabled | boolean | Whether voice/phone is enabled |
agents[].createdAt | string | ISO 8601 creation timestamp |
total | integer | Total number of agents |
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |