List assistants (paginated)
Authorization
bearerAuth API key in the Authorization: Bearer <key> header.
Keys are created in the SMAO dashboard (Settings → API Keys).
In: header
Query Parameters
Opaque cursor from a prior meta.next_cursor. Base64url-encoded
(unpadded) — do not parse or construct it manually.
^[A-Za-z0-9_-]+$Items per page (1–100, default 50).
1 <= value <= 10050Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/assistants"{ "data": [ { "id": "string", "name": "string", "description": "string", "language": "de", "voice_id": "string", "record_call": true, "speed": 0.7, "tts_style_level": 0, "background_ambience": "clean", "interruptable": true, "appointment_booking_enabled": true, "contextual_asr_correction_enabled": true, "allow_preferred_language": true, "whitelist": true, "introduction": "string", "company_name": "string", "company_industry": "string", "phone_number": "string", "carrier": "string", "prompt_id": "string", "email_prompt_id": "string", "knowledge_group_ids": [ "string" ], "glossary_group_ids": [ "string" ], "pronunciation_group_ids": [ "string" ], "forwarding_group_ids": [ "string" ], "contact_group_ids": [ "string" ], "calendar_ids": [ "string" ], "tool_ids": [ "string" ], "analysis_ids": [ "string" ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "meta": { "has_more": true, "next_cursor": "string" }}Health check GET
Confirms the API is reachable and your API key is valid.
Create an assistant POST
Creates a new assistant and provisions a phone number for it. The `phone_number` field on the response is assigned by the platform — callers cannot set or change it via this API. Cross-resource refs (prompt_id, knowledge_group_ids, etc.) are validated to belong to your organization before the assistant is saved.