Developers / Playground
Sandbox Production Agent context: Clinic-Intake ▾ sk_test_9aD4…X87P ▾
Reference →

Endpoint

POST https://api.jvapi.ai/v1/calls

Authorization ▾

Using Sandbox key. Switch to Production to use sk_live_*.

Headers ▾

Query params ▾

No query parameters for this endpoint.

Body JSON ▾

{
  "agent":    "agt_clinic_intake",
  "to":       "+14155550119",
  "from":     "+14155550100",
  "voice":    "nova_v2",
  "tools":    ["lookup_calendar", "book_slot", "send_sms"],
  "amd":       "detect_or_drop",
  "recording": "full",
  "metadata": {
    "patient_id": "pat_8821",
    "source":     "playground"
  }
}
200 OK latency 184ms size 316 B region us-east-1
Response Headers cURL Python Node Go 
{
  "id":         "call_01HK7X8Z5YJVWQ3N5T8K9XQPZ4",
  "status":     "dialing",
  "agent":      "agt_clinic_intake",
  "to":         "+14155550119",
  "from":       "+14155550100",
  "voice":      "nova_v2",
  "recording":  "full",
  "amd":        "detect_or_drop",
  "metadata":   {
    "patient_id": "pat_8821",
    "source":     "playground"
  },
  "cost_estimate_usd": 0.02,
  "created":    "2026-04-17T19:24:12.884Z"
}
Response Headers cURL Python Node Go 
# Ready to paste in your terminal
curl https://api.jvapi.ai/v1/calls \
  -H "Authorization: Bearer $JVAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: c8a8-idem-4417" \
  -d '{
    "agent": "agt_clinic_intake",
    "to":    "+14155550119",
    "from":  "+14155550100",
    "voice": "nova_v2",
    "tools": ["lookup_calendar","book_slot","send_sms"],
    "amd":   "detect_or_drop",
    "recording": "full",
    "metadata": { "patient_id": "pat_8821" }
  }'
Recent POST/v1/calls· 184ms · 200 GET/v1/agents· 44ms · 200 POST/v1/sessions· 212ms · 200 GET/v1/calls/call_01HK7X…· 38ms · 200 PATCH/v1/agents/agt_clinic_intake· 72ms · 200 POST/v1/calls· 198ms · 200 GET/v1/voices· 56ms · 200 POST/v1/calls· 124ms · 422 GET/v1/knowledge· 88ms · 200 POST/v1/knowledge/query· 46ms · 200