Recordings

Inspect recording lifecycle state and obtain playback URLs.

Recordings are organization-scoped resources associated with calls.

The API exposes:

GET    /v1/recordings/
GET    /v1/recordings/{id}
GET    /v1/recordings/{id}/playback
DELETE /v1/recordings/{id}

Recording state can be recording, completed, failed, or deleted. Metadata can include file size, format, duration, start/completion timestamps, and the parent call_id.

The playback endpoint returns a URL plus an expiration timestamp instead of requiring clients to know the runtime’s recording storage layout.

Recording lifecycle events include recording.started, recording.completed, recording.failed, and recording.deleted.