Sign in

v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB
Agents

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 are omitted from 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.

delete/agents/calls/{call_id}

Path parameters

call_idstring required

The ID of the call.

Headers

Cartesia-Version'2026-03-01' date required
Example:2026-03-01

API version header.

Response

The call record with sensitive fields deleted.

idstring required

The unique identifier for the agent call.

agent_idstring required

The identifier of the agent associated with the call.

agent_namestring

The name of the agent associated with the call.

zdr_enabledboolean

Whether the call was handled with zero data retention (ZDR) enabled. When true, sensitive call data such as the transcript, audio recording, and logs is not retained.

start_timestring date-time nullable

The start time of the agent call.

end_timestring date-time nullable

The end time of the agent call.

redacted_atstring date-time nullable

When the call's sensitive data was deleted, if it has been. Set by DELETE /agents/calls/{call_id}; deleted fields are omitted from responses.

telephony_account_type'cartesia' | 'twilio' | 'sip_trunk' nullable

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.

summarystring nullable

A summary of the agent call. This is a brief summary of the call that is generated by Cartesia.

status'created' | 'started' | 'completed' | 'failed' required

The status of an agent call.

error_messagestring nullable

The error message, if any, associated with the call.

end_reason'agent_hangup' | 'client_hangup' | 'api_cancelled' | 'max_duration' | 'inactivity' | 'client_disconnected' | 'dial_busy' | 'dial_failed' | 'dial_no_answer' | 'error'

A machine-readable enum indicating why a call ended.

deployment_idstring nullable

The deployment identifier associated with the call.

deployment_version_idstring nullable

The specific deployment version identifier associated with the call.

deployment_region'US' | 'EU' | 'APAC' nullable

The deployment region that handled the call.

metadataobject nullable

Custom metadata associated with the call.