List Agents
Returns the list of agents belonging to the workspace associated with your API key.
Request
| Header | Required | Description |
|---|
Authorization | Yes | API key in Bearer snorbe_... format |
The workspace is automatically resolved from your API key. No parameters required.
Response
[
{
"id": "clxxx123456",
"name": "Research Agent",
"isDefault": true,
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-03-20T14:22:00.000Z"
},
{
"id": "clxxx789012",
"name": "Patent Analyst",
"isDefault": false,
"createdAt": "2026-02-10T08:00:00.000Z",
"updatedAt": "2026-02-10T08:00:00.000Z"
}
]
Response Fields
| Field | Type | Description |
|---|
id | string | Agent ID |
name | string | Agent name |
isDefault | boolean | Whether this is the default agent |
createdAt | string | Creation timestamp (ISO 8601) |
updatedAt | string | Last update timestamp (ISO 8601) |
Examples
curl "https://app.snorbe.deskrex.ai/api/v1/agent/list" \
-H "Authorization: Bearer snorbe_your_api_key_here"
Error Responses
| HTTP Status | Code | Description |
|---|
| 401 | UNAUTHORIZED | Invalid, expired, or missing API key |
| 429 | TOO_MANY_REQUESTS | Rate limit exceeded |
