calls.recording_expired

Summary

calls.recording_expired is returned when a recording existed at some point but has since been deleted by the workspace's storage-tier retention sweep. Unlike calls.recording_not_found, this error indicates the recording was created but is no longer available due to retention policy.

Cause

The workspace's storage tier has a retention window, and the recording's age exceeded the configured retention period. The retention sweep pruned the file.

Resolution

Upgrade the workspace storage tier for a longer retention window. If the recording is needed immediately, it cannot be recovered once pruned. Archive recordings externally before they expire by subscribing to call.recording.ready.

Example response

{
  "error": {
    "code": "calls.recording_expired",
    "message": "recording has been pruned by retention policy",
    "request_id": "req_01900000abc"
  }
}

Next steps

• See Storage API for tier upgrade options.
• Subscribe to call.recording.ready via Webhooks to archive recordings before expiry.