GET/api/v1/assistants
Assistants
List Assistants
Returns a paginated, lightweight list of assistants scoped to the owner of the API key. Each item includes only the assistant id, name, and timestamps — fetch GET /api/v1/assistants/{id} for the full model, voice, transcription, and advanced configuration.
Request
Endpoint
GET
/api/v1/assistantsAuthentication
x-api-keyorAuthorization: BearerQuery Parameters
| Name | Type | Description |
|---|---|---|
page | integer | Page number. Values below 1 are clamped to 1. |
limit | integer | Maximum items to return. Defaults to 20 and is capped at 100. Passing 0 is clamped to 1. |
Notes
List items are intentionally slim — only id, name, created_at, and updated_at are returned.
Use GET /api/v1/assistants/{id} to retrieve the full assistant configuration.
Response Example
response.json
{
"success": true,
"data": [
{
"id": "665f1a2b3c4d5e6f7a8b9c0d",
"name": "Sales Bot",
"created_at": "2026-05-01T10:00:00.000Z",
"updated_at": "2026-05-02T08:30:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1
}
}Status Codes
| HTTP | Meaning | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 401 | Unauthorized | Missing, invalid, inactive, or origin-restricted API key. |
| 429 | Rate limited | Per-IP or per-key request budget was exceeded. |
Security Model
User-scoped by default
This endpoint only sees resources owned by the user attached to the API key. If another user's id is supplied, the API responds as if the resource does not exist.