Aiera Voice API Reference

Authorization: Bearer aml_live_your_api_key

curl -X POST https://aiera-voice.com/api/public/v1/agents \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales qualifier",
    "welcome_message": "Hello, this is Aiera calling. Do you have a moment to talk?",
    "prompt": "You are a polite sales assistant. Ask two qualification questions, then say goodbye.",
    "language": "en",
    "voice_provider": "elevenlabs",
    "voice_id": "V9LCAAi4tTlqe9JadbCo",
    "voice_label": "Nila",
    "transcriber_provider": "deepgram",
    "transcriber_model": "nova-3",
    "llm_model": "gpt-4o-mini",
    "max_tokens": 150,
    "temperature": 1,
    "telephony_provider": "plivo",
    "max_call_seconds": 300,
    "hangup_after_silence": 10,
    "languages": []
  }'

curl -X POST https://aiera-voice.com/api/public/v1/calls \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "<agent-uuid>",
    "to": "+919876543210",
    "from": "+14155551234",
    "variables": { "customer_name": "Rahul" }
  }'

curl -L https://aiera-voice.com/api/public/v1/recordings/<recording-token>.mp3 \
  -H "Authorization: Bearer aml_live_your_key" \
  -o call-recording.mp3

# Search available numbers
curl -X POST https://aiera-voice.com/api/public/v1/numbers/search \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","pattern":"555"}'

# Buy one
curl -X POST https://aiera-voice.com/api/public/v1/numbers/buy \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","phone_number":"+14155551234"}'

# Link to an agent
curl -X POST https://aiera-voice.com/api/public/v1/numbers/<number-id>/link \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"<agent-uuid>"}'

curl -X POST https://aiera-voice.com/api/public/v1/knowledge \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://aieramindlabs.com/faq",
    "chunk_size": 1000,
    "similarity_top_k": 3,
    "overlapping": 100
  }'

curl -X POST https://aiera-voice.com/api/public/v1/batches \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "<agent-uuid>",
    "csv": "phone,name\n+919876543210,Rahul\n+919876543211,Priya",
    "from_numbers": ["+14155551234"],
    "scheduled_at": "2026-09-15T10:00:00+05:30"
  }'

curl "https://aiera-voice.com/api/public/v1/voices?provider_id=elevenlabs&model_id=eleven_turbo_v2_5&language=en" \
  -H "Authorization: Bearer aml_live_your_key"

curl -X POST https://aiera-voice.com/api/public/v1/agents/<agent-id>/outcomes \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "interested",
    "question": "Was the caller interested?",
    "model": "gpt-4.1-mini",
    "options": [
      { "value": "yes", "condition": "caller expressed interest" },
      { "value": "no",  "condition": "caller declined",
        "sub_options": [ { "value": "price", "condition": "declined on price" } ] }
    ]
  }'

curl "https://aiera-voice.com/api/public/v1/agents/<agent-id>/executions?start_date=2026-09-11&end_date=2026-09-12&page_size=50" \
  -H "Authorization: Bearer aml_live_your_key"

curl -X POST https://aiera-voice.com/api/public/v1/inbound \
  -H "Authorization: Bearer aml_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "agent_id": "<agent-id>", "phone_number": "+14155551234" }'

curl https://aiera-voice.com/api/public/v1/account \
  -H "Authorization: Bearer aml_live_your_key"

const crypto = require("crypto");

const secret = process.env.AIERA_WEBHOOK_SECRET; // from the console
const signature = req.headers["x-aiera-signature"]; // t=1234567890,v1=abc...
const body = JSON.stringify(req.body);

const [t, v1] = signature.split(",").map((part) => part.split("=")[1]);
const expected = crypto
  .createHmac("sha256", secret)
  .update(`${t}.${body}`)
  .digest("hex");

if (expected !== v1) {
  return res.status(401).send("Invalid signature");
}

{
  "event": "call.completed",
  "data": {
    "id": "<call-uuid>",
    "agent_id": "<agent-uuid>",
    "to": "+919876543210",
    "from": "+14155551234",
    "status": "completed",
    "duration_seconds": 120,
    "cost": 0.42,
    "recording_url": "https://aiera-voice.com/api/public/v1/recordings/<token>.mp3",
    "transcript": [...],
    "extracted_data": { "interested": "yes" },
    "created_at": "2026-09-12T10:00:00Z",
    "updated_at": "2026-09-12T10:02:00Z"
  }
}

{
  "error": {
    "message": "agent_id is required",
    "status": 400
  }
}