Recordings

List, download, and delete call recordings captured by <Record> or <RecordSession>.

GET/recordings/

List recordings. Query: call_uuid (string, optional), limit (integer, default 50, max 200), offset (integer, default 0). Returns array<Recording>.

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.

POST/recordings/delete

Soft-delete a recording. Body { uuid: string }. Returns { message: string }.

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.