Developers
API and keys
Version 1 of the Aurtio API. Manage your employees, and read calls, leads and bookings, from your own software. Base address: https://api.aurtio.ai/v1
#Authentication
GET /v1/agents
Every request needs an API key. In the app, open Settings → For developers → API keys, give the key a Key name and press Create key. Only the workspace owner can. Copy the key (pk_live_…) straight away: it is shown once.
Send it as a bearer token:
Authorization: Bearer pk_live_…
or in an X-API-Key: pk_live_… header. A key sees only its own workspace: its employees, calls, leads and bookings. To revoke a key, press Delete next to it; any app using it stops working at once.
Keep keys on your server. Never put a pk_live_ key in a web page or an app.
curl https://api.aurtio.ai/v1/agents \
-H "Authorization: Bearer $AURTIO_KEY"const res = await fetch("https://api.aurtio.ai/v1/agents", {
headers: { Authorization: `Bearer ${process.env.AURTIO_KEY}` },
});
const agents = await res.json();import os, requests
res = requests.get("https://api.aurtio.ai/v1/agents",
headers={"Authorization": f"Bearer {os.environ['AURTIO_KEY']}"})
agents = res.json()#Rate limits
Each key can make 60 requests a minute. Every response tells you where you stand:
| Header | Example | What it is |
|---|---|---|
X-RateLimit-Limit | 60 | Requests allowed per minute. |
X-RateLimit-Remaining | 57 | Requests left in this minute. |
X-RateLimit-Reset | 1762597860 | Unix time when the minute resets. |
Over the limit, you get 429 with a Retry-After header: the seconds to wait.
#Errors
Errors use standard HTTP codes and a JSON body with a detail line:
{ "detail": "invalid or revoked API key" }| Code | Meaning | What to do |
|---|---|---|
400 | Bad request | A required field is missing or a value isn't allowed. The detail says which. |
401 | No key, or a wrong or revoked one | Check the Authorization header. |
404 | Not found | It doesn't exist, or it isn't in your workspace. Both look the same, on purpose. |
429 | Rate limited | Wait for Retry-After seconds, then retry. |
#Agents
An agent is one of your AI employees.
GET /v1/agents
Lists your employees.
curl https://api.aurtio.ai/v1/agents \
-H "Authorization: Bearer $AURTIO_KEY"POST /v1/agents
Creates an employee. Returns 201 with the new employee.
| Field | Type | What it is |
|---|---|---|
name | string, required | The employee's name. |
system_prompt | string, required | Its instructions: who it is and how it answers. |
language | string | Language code. Default hi (Hindi). |
greeting | string | The first thing it says on a call. |
Your plan includes a set number of employees. When they are all in use, the request fails with a message saying so: add one from the app, then retry.
curl -X POST https://api.aurtio.ai/v1/agents \
-H "Authorization: Bearer $AURTIO_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Front Desk", "language": "hi",
"system_prompt": "You are the front desk of Sharma Dental…",
"greeting": "नमस्ते! मैं आपकी कैसे मदद कर सकती हूँ?"}'GET /v1/agents/{id}
Gets one employee.
curl https://api.aurtio.ai/v1/agents/$AGENT_ID \
-H "Authorization: Bearer $AURTIO_KEY"PUT /v1/agents/{id}
Updates an employee. Send only the fields you want to change.
curl -X PUT https://api.aurtio.ai/v1/agents/$AGENT_ID \
-H "Authorization: Bearer $AURTIO_KEY" \
-H "Content-Type: application/json" \
-d '{"greeting": "Namaste! Sharma Dental, how can I help?"}'DELETE /v1/agents/{id}
Deletes an employee.
curl -X DELETE https://api.aurtio.ai/v1/agents/$AGENT_ID \
-H "Authorization: Bearer $AURTIO_KEY"{ "ok": true }#Calls
GET /v1/calls
Lists calls, newest first.
| Query | Type | What it is |
|---|---|---|
agent_id | string | Only this employee's calls. |
limit | number | How many. Default 50, at most 200. |
curl "https://api.aurtio.ai/v1/calls?limit=10" \
-H "Authorization: Bearer $AURTIO_KEY"[
{
"id": "<call id>",
"agent_id": "<employee id>",
"room": "call-…",
"direction": "inbound",
"started_at": "2026-11-08T10:29:18+00:00",
"duration_sec": 42.0,
"cost_inr": 1.4,
"disposition": "lead",
"caller_e164": null,
"turns": 6
}
]GET /v1/calls/{id}
Gets one call, with its transcript and its summary.
curl https://api.aurtio.ai/v1/calls/$CALL_ID \
-H "Authorization: Bearer $AURTIO_KEY"DELETE /v1/calls/{id}
Deletes a call, with its transcript and summary. Use it when a customer asks you to erase their data.
curl -X DELETE https://api.aurtio.ai/v1/calls/$CALL_ID \
-H "Authorization: Bearer $AURTIO_KEY"{ "ok": true }#Leads and bookings
GET /v1/leads
Lists leads, newest first. limit: default 100, at most 500.
curl "https://api.aurtio.ai/v1/leads?limit=20" \
-H "Authorization: Bearer $AURTIO_KEY"[
{
"id": "<lead id>",
"name": "Ravi",
"phone": "98765…",
"requirement": "dental appointment",
"call_room": "call-…",
"status": "new",
"created_at": "2026-11-08T10:29:41+00:00",
"agent_name": "Front Desk"
}
]GET /v1/bookings
Lists bookings, newest first. when_text is the time in the caller's words; starts_at is filled when the time could be read exactly. limit: default 100, at most 500.
curl "https://api.aurtio.ai/v1/bookings?limit=20" \
-H "Authorization: Bearer $AURTIO_KEY"[
{
"id": "<booking id>",
"name": "Ravi",
"when_text": "kal shaam 5 baje",
"starts_at": null,
"purpose": "consultation",
"call_room": "call-…",
"created_at": "2026-11-08T10:29:55+00:00",
"agent_name": "Front Desk"
}
]DELETE /v1/leads/{id}
Deletes a lead. DELETE /v1/bookings/{id} deletes a booking. Both answer { "ok": true }.
curl -X DELETE https://api.aurtio.ai/v1/leads/$LEAD_ID \
-H "Authorization: Bearer $AURTIO_KEY"#Knowledge
GET /v1/agents/{id}/knowledge
Lists what an employee has been taught, with each source's status.
curl https://api.aurtio.ai/v1/agents/$AGENT_ID/knowledge \
-H "Authorization: Bearer $AURTIO_KEY"POST /v1/agents/{id}/knowledge
Teaches an employee from a web page or from text. Returns 201; the source is read in the background.
| Field | Type | What it is |
|---|---|---|
type | string, required | url or text. |
url | string | The page to read, when type is url. |
content | string | The text, when type is text. |
name | string | A label for the source. |
Each source you add uses 1 credit, charged once, the same as adding it in the app.
curl -X POST https://api.aurtio.ai/v1/agents/$AGENT_ID/knowledge \
-H "Authorization: Bearer $AURTIO_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "url", "url": "https://sharmadental.in/timings"}'curl -X POST https://api.aurtio.ai/v1/agents/$AGENT_ID/knowledge \
-H "Authorization: Bearer $AURTIO_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "text", "name": "Fees",
"content": "Consultation ₹500. Cleaning ₹1,200."}'#Webhook endpoints
POST /v1/webhooks
Adds an endpoint. events is any of call.ended, lead.captured, booking.created, call.summary; an empty list means all. The secret is in this response only. See Webhooks for what arrives.
curl -X POST https://api.aurtio.ai/v1/webhooks \
-H "Authorization: Bearer $AURTIO_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/aurtio",
"events": ["lead.captured", "booking.created"]}'{
"id": "<endpoint id>",
"url": "https://example.com/aurtio",
"events": ["lead.captured", "booking.created"],
"enabled": true,
"created_at": "2026-11-08T10:00:00+00:00",
"secret": "whsec_…"
}GET /v1/webhooks
Lists your endpoints, with delivered and failed counts. The secret is masked.
curl https://api.aurtio.ai/v1/webhooks \
-H "Authorization: Bearer $AURTIO_KEY"POST /v1/webhooks/{id}/test
Sends a test.ping to the endpoint. DELETE /v1/webhooks/{id} removes an endpoint.
curl -X POST https://api.aurtio.ai/v1/webhooks/$ENDPOINT_ID/test \
-H "Authorization: Bearer $AURTIO_KEY"{ "ok": true, "queued": "test.ping" }#OpenAPI spec
The machine-readable spec for every route is at https://api.aurtio.ai/v1/openapi.json. Load it into Postman, Insomnia or your code generator.