SMAO API Documentation
Public APIAssistants

List assistants (paginated)

GET
/assistants
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Query Parameters

cursor?string

Opaque cursor from a prior meta.next_cursor. Base64url-encoded (unpadded) — do not parse or construct it manually.

Match^[A-Za-z0-9_-]+$
limit?integer

Items per page (1–100, default 50).

Default50
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.smao.ai/api/v1/assistants"
{
  "data": [
    {
      "id": "65f8fa6f1a9d8e0012ab34cd",
      "name": "Sarah",
      "description": "Receptionist assistant for inbound calls.",
      "language": "de",
      "voice_id": "cgSgspJ2msm6clMCkdW9",
      "record_call": true,
      "pickup_delay": 5,
      "speed": 0.7,
      "tts_style": "consistent",
      "background_ambience": "clean",
      "interruptable": true,
      "appointment_booking_enabled": true,
      "allow_preferred_language": true,
      "whitelist": true,
      "introduction": "string",
      "company_name": "string",
      "company_industry": "string",
      "phone_number": "+491701234567",
      "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"
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "Validation failed"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Missing API key"
  }
}
{
  "error": {
    "code": "subscription_required",
    "message": "This feature is not available in your current subscription. Please upgrade to a higher plan"
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "No permission"
  }
}
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded"
  }
}
{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred."
  }
}