Retrieve a call's recording
Returns a reference to the call's audio recording as { object: "phone_call.recording", callId, objectId }, where objectId is a Dairo storage object you download through storage's signed-link path rather than a raw, unauthenticated URL.
Returns a reference to the call's audio recording as { object: "phone_call.recording", callId, objectId }, where objectId is a Dairo storage object you download through storage's signed-link path rather than a raw, unauthenticated URL. Every connected call is recorded; a call that never connected, or whose recording is not ready yet, returns 404. Requires the phone:read scope.
Scope: phone:read. Send the API key as a bearer token; Scopes lists what each one reaches.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | yes | The phone call's ID. |
Response
200 Success. Body: application/json, PhoneCallRecording.
| Field | Type | Required | Description |
|---|---|---|---|
object | "phone_call.recording" | yes | |
callId | string (uuid) | yes | |
objectId | string (uuid) | yes | A Dairo storage object; fetch it through the storage API. |
Errors
Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.
| Status | Meaning |
|---|---|
400 | The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch). |
401 | The API key is missing or invalid. |
403 | The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted). |
404 | No such resource in this account (resource_not_found). |
429 | Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached). |
500 | An unexpected error; retry with backoff, then contact support (internal_error). |
Retrieve a call's transcript
Returns the turn-by-turn transcript as { object: "phone_call.transcript", callId, turns }, where each turn has role, content, and timestamp.
End a live call
Ends a live call immediately, tearing the connection down so a runaway agent or a call stuck on voicemail stops ringing and stops billing the moment this returns.