Callina.aiDocs

API reference

OpenAPI 3.1 specification, authentication, error codes.

The Callina REST API gives you programmatic access to assistants, phone numbers, calls, transcripts, outbound campaigns and tenant administration.

Base URL

https://api.callina.ai/v1

Authentication

All requests use a bearer API key. Generate keys in Settings → API keys. Keys are scoped per tenant — you cannot access another tenant's data with a key from your own.

Authorization: Bearer sk_live_a1b2c3d4...

OpenAPI specification

The full machine-readable spec is at:

https://api.callina.ai/v1/openapi.json

Drop it into Postman, Insomnia, or your code generator of choice.

Resources

  • /v1/assistants — list, create, update, delete assistants
  • /v1/phone-numbers — manage Callina-provided and imported numbers
  • /v1/calls — list calls, get transcripts, get audio
  • /v1/outbound/calls — trigger an outbound call (see Outbound API)
  • /v1/campaigns — manage outbound campaigns
  • /v1/tools — define custom webhook-tools (see Integrations)
  • /v1/tenants/me — current tenant info

Errors

{
  "error": {
    "type": "invalid_request",
    "message": "The 'to' field must be a valid E.164 phone number.",
    "code": "outbound.invalid_to"
  },
  "request_id": "req_abc123"
}

Always include request_id when contacting support@callina.ai.