Fetch a call's audio recording (WAV)
Streams the recording as audio/wav, in stereo: the caller on the left channel, the agent on the right. Not enveloped, and often several megabytes. Absent when recording is off for the number, or when the call never connected.
Requires the read scope. A key with less gets 403 insufficient_scope.
Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.
In: header
Path Parameters
The call's id.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/calls/string/recording"List calls, newest first (cursor-paginated)
Every call, inbound and outbound, including campaign calls. Filter by agent, number, campaign, direction, disposition or date range. A campaign filter here returns every ATTEMPT including retries, which the recipient list cannot give you.
Hand a live call to a person
Asks the agent on the call to transfer it to one of the destinations it may use, exactly as if it had decided to itself: the caller hears the transfer line, the person hears the brief, and every rule still applies — the destination must be verified, inside its hours and one of the agent's destinations, and a call makes at most two attempts. A transfer that cannot start is accepted: false with a refusal, not an error. 409 call_not_live when no agent is on the call. Send an Idempotency-Key to make a retry safe.