Get an assistant
Authorization
bearerAuth API key in the Authorization: Bearer <key> header.
Keys are created in the SMAO dashboard (Settings → API Keys).
In: header
Path Parameters
^[a-f0-9]{24}$Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/assistants/65f8fa6f1a9d8e0012ab34cd"{ "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" }}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.
Update an assistant PATCH
Partial update — only included fields are changed. `phone_number` and `carrier` are read-only and cannot be updated via this endpoint. Cross-resource refs are validated to belong to your organization.