Aurtio
Aurtio
Join the waitlist
Docs menu
On this page

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"

#Rate limits

Each key can make 60 requests a minute. Every response tells you where you stand:

HeaderExampleWhat it is
X-RateLimit-Limit60Requests allowed per minute.
X-RateLimit-Remaining57Requests left in this minute.
X-RateLimit-Reset1762597860Unix 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:

401
{ "detail": "invalid or revoked API key" }
CodeMeaningWhat to do
400Bad requestA required field is missing or a value isn't allowed. The detail says which.
401No key, or a wrong or revoked oneCheck the Authorization header.
404Not foundIt doesn't exist, or it isn't in your workspace. Both look the same, on purpose.
429Rate limitedWait for Retry-After seconds, then retry.

#Agents

An agent is one of your AI employees.

GET /v1/agents

Lists your employees.

cURL
curl https://api.aurtio.ai/v1/agents \
  -H "Authorization: Bearer $AURTIO_KEY"

POST /v1/agents

Creates an employee. Returns 201 with the new employee.

FieldTypeWhat it is
namestring, requiredThe employee's name.
system_promptstring, requiredIts instructions: who it is and how it answers.
languagestringLanguage code. Default hi (Hindi).
greetingstringThe 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
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
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
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"

#Calls

GET /v1/calls

Lists calls, newest first.

QueryTypeWhat it is
agent_idstringOnly this employee's calls.
limitnumberHow many. Default 50, at most 200.
curl "https://api.aurtio.ai/v1/calls?limit=10" \
  -H "Authorization: Bearer $AURTIO_KEY"

GET /v1/calls/{id}

Gets one call, with its transcript and its summary.

cURL
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"

#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"

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"

DELETE /v1/leads/{id}

Deletes a lead. DELETE /v1/bookings/{id} deletes a booking. Both answer { "ok": true }.

cURL
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
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.

FieldTypeWhat it is
typestring, requiredurl or text.
urlstringThe page to read, when type is url.
contentstringThe text, when type is text.
namestringA 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"}'

#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"]}'

GET /v1/webhooks

Lists your endpoints, with delivered and failed counts. The secret is masked.

cURL
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"

#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.