Recordings
List, download, and delete call recordings captured by <Record> or <RecordSession>.
List recordings
Section titled “List recordings”GET /recordings/
| Query | Type | Default | Description |
|---|---|---|---|
call_uuid |
string | - | Filter to one call. |
limit |
integer | 50 |
Max 200. |
offset |
integer | 0 |
Rows to skip. |
Returns array<Recording>.
Get a download URL
Section titled “Get a download URL”POST /recordings/download
Get a time-limited download URL.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
uuid |
string | Required | - | The recording. |
ttl_seconds |
integer | Optional | 300 |
How long the URL stays valid. |
Returns { url: string, expires_in: integer }. Errors: 404 not found, 410 deleted.
Delete a recording
Section titled “Delete a recording”POST /recordings/delete
Soft-delete a recording. Body { uuid: string }. Returns { message: string }.
The Recording object
Section titled “The Recording object”| Field | Type | Description |
|---|---|---|
uuid |
string | Stable identifier. |
call_uuid / call_sid |
string | The call this recording belongs to. |
duration_seconds |
integer, nullable | Length of the audio. |
size_bytes |
integer, nullable | File size. |
media_format |
string | Audio format, e.g. wav. |
storage_backend |
string | Where the file lives. |
expires_at |
string, nullable | When it will be purged. |
created_at |
string | ISO-8601 timestamp. |