Delete a call recording from S3.

DELETE /api/v1/calls/:callId/recording → 204

Charges for actual storage duration before deletion (billing at lifecycle end). Uses idempotency key to prevent double-charging if racing with retention job.

SECURITY: Verifies account access, call ownership.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

callIdstringRequiredformat: "uuid"
Call ID

Response

Recording deleted

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error