Web calls

Create web call (legacy path)

Backward-compatible alias of POST /api/ext/web/make-web-call — starts a browser/WebRTC voice session with an agent and returns a connection token. Pass the agent_id and optionally an identity, prompt variables, and extra_data; the response token is what your frontend uses to join the live audio session. Prefer the canonical /api/ext/web/make-web-call for new integrations; this path is kept only for compatibility.

Legacy path. Kept for existing integrations. New integrations should use Create web call.

POST

https://api.nabrah.ai/api/ext/make-web-call

curl --request POST \
  --url 'https://api.nabrah.ai/api/ext/make-web-call' \
  --header 'X-API-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": "00000000-0000-4000-8000-000000000000"
}'

{
  "token": "string"
}

Alias notice

Equivalent to /api/ext/web/make-web-call

Same request body (WebCallRequest) and response (token). Use the canonical /api/ext/web/make-web-call going forward.

Request fields

agent_id

UUID of the agent that will answer the web call. List agents with GET /api/ext/agent.

agent_id

identity

Optional client/participant identity for the session, used to label the joining user in the realtime connection.

identity

variables / extra_data

Optional prompt template variables and free-form context passed into the call.

variablesextra_data

Response

token

Connection token your browser/WebRTC client uses to join the live voice session. Treat it as short-lived and single-session.

token

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Body

application/json

Start a web call with just an agent.

Minimal

{
  "agent_id": "00000000-0000-4000-8000-000000000000"
}

Response

200

Successful Response

application/json

422

Validation Error

application/json