API reference

The same API the dashboard uses — versioned at /v1 and authenticated with per-tenant keys. Everything you see in your workspace, your code can reach.

Open the live interactive reference

Authentication

Create an API key in Dashboard → Settings → API keys(it's shown once). Send it on every request as a bearer token — or the X-API-Key header. Keys are per-tenant: you only ever see your own data.

bash

curl https://api.aurtio.ai/v1/agents \
  -H "Authorization: Bearer pk_live_…"

# X-API-Key: pk_live_…  also works

Rate limits & errors

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Exceed the limit and you get 429 with a Retry-After header.

Errors use standard HTTP status codes with a JSON body {"detail": "reason"}: 401 bad or revoked key, 404 not yours or missing, 429 rate limited.

Endpoints

Agents

GET/v1/agents

POST/v1/agents

GET/v1/agents/{id}

PUT/v1/agents/{id}

DELETE/v1/agents/{id}

Calls

GET/v1/calls

GET/v1/calls/{id}

DELETE/v1/calls/{id}

Leads & bookings

GET/v1/leads

DELETE/v1/leads/{id}

GET/v1/bookings

DELETE/v1/bookings/{id}

Numbers

GET/v1/numbers

Knowledge

GET/v1/agents/{id}/knowledge

POST/v1/agents/{id}/knowledge

Webhooks

GET/v1/webhooks

POST/v1/webhooks

DELETE/v1/webhooks/{id}

POST/v1/webhooks/{id}/test

Pricing

GET/v1/catalog

Example

bash

# create an agent
curl -X POST https://api.aurtio.ai/v1/agents \
  -H "Authorization: Bearer pk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Front Desk", "language": "hi",
       "greeting": "नमस्ते! कैसे मदद कर सकती हूँ?"}'

# read your recent calls
curl "https://api.aurtio.ai/v1/calls?limit=10" \
  -H "Authorization: Bearer pk_live_…"

WebhooksSigned events for calls, leads, and bookings.