Delete Call
Deletes the sensitive data for a call, including the transcript, audio recordings, and logs. The call record is retained with non-sensitive operational metadata; deleted fields return null in subsequent API responses, and redacted_at marks when deletion occurred. Deletion cannot be undone.
Only completed or failed calls can be deleted. Cancel an active call first via POST /agents/calls/{call_id}/cancel.
Documentation Index
Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
2026-03-01 "2026-03-01"
Path Parameters
The ID of the call.
Response
The call record with sensitive fields deleted.
The unique identifier for the agent call.
The identifier of the agent associated with the call.
The status of the agent call.
created, started, completed, failed The name of the agent associated with the call.
The start time of the agent call.
The end time of the agent call.
When the call's sensitive data was deleted, if it has been. Set by DELETE /agents/calls/{call_id}; deleted fields return null.
The transcript of the agent call.
The telephony parameters associated with the call when the call is made via phone.
The telephony account type backing the call. cartesia is the default Cartesia-hosted path; twilio indicates a customer-owned Twilio subaccount; sip_trunk indicates a LiveKit SIP trunk.
cartesia, twilio, sip_trunk A summary of the agent call. This is a brief summary of the call that is generated by Cartesia.
The error message, if any, associated with the call.
The reason why the call ended.
agent_hangup, client_hangup, api_cancelled, max_duration, inactivity, client_disconnected, dial_busy, dial_failed, dial_no_answer, error The deployment identifier associated with the call.
The specific deployment version identifier associated with the call.
The deployment region that handled the call.
US, EU, APAC Custom metadata associated with the call.