Check a recording

head

https://api.emaktalk.com/api/v2/call_records/{id}/recordings/{recording_id}

The same status and headers as GET, with no body, except that a 302's Location is a link that answers HEAD only: request it to read the audio's Content-Type and Content-Length without fetching the audio. Never recorded in the access log.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

uuid

required

The call record's id (a record's id).

recording_id

uuid

required

The recording's id: the id of one of the record's recordings.

Query Params

download

boolean

Defaults to false

true: the link serves the audio as a file download (Content-Disposition: attachment) named for the call. false (the default): for playback. A recording's download_url is its media_url with download=true.

account_id

uuid

The one account to read, by its id (account.id). Only a caller that may choose the account (EMAK support) sends it, and must; everyone else reads the account they belong to. Absent for a caller that must name it: 400 parameter_missing. Empty or not an account id: 400 parameter_invalid. Given twice: 400 parameter_invalid for any caller. Sent by a caller that reads its own account: 403 forbidden. An account that does not exist or is disabled: 404 reference_not_found. Each names account_id in param. The account is named this way only: a request that sends the legacy account header X-Tenant-Domain-Uuid is refused (400 parameter_unknown).

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

302The recording is playable. Location answers HEAD only, for one hour.

400As for GET: the request is malformed. No body; send the request as GET to read the error.

401As for GET: no valid credentials. No body.

403As for GET: the caller may not read this. No body.

404As for GET: nothing readable here. No body.

405As for GET. No body.

429As for GET: too many requests. No body; wait Retry-After seconds.

500As for GET: something failed on our side. No body.

503As for GET: a temporary condition. No body; wait Retry-After seconds.