---
title: "Delete Call"
method: DELETE
path: "/agents/calls/{call_id}"
tags: ["Agents"]
---

# Delete Call

`DELETE /agents/calls/{call_id}`

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`.

## Path parameters

- `call_id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

The call record with sensitive fields deleted.

- AgentCall
  - `id` string, required — The unique identifier for the agent call.
  - `agent_id` string, required — The identifier of the agent associated with the call.
  - `agent_name` string — The name of the agent associated with the call.
  - `zdr_enabled` boolean — 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_time` string, date-time, nullable — The start time of the agent call.
  - `end_time` string, date-time, nullable — The end time of the agent call.
  - `redacted_at` string, 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.
  - `transcript` AgentTranscript[], nullable — The transcript of the agent call.
    - `role` string, required — The role of the participant in the conversation. Roles are `user`, `assistant`, or `system`. `assistant` is the agent. `system` is used to indicate logs during the conversation such as `log_event` or `log_metric`.
    - `text` string, nullable — The text content of the transcript. This is the text that was spoken by the user or the agent.
    - `start_timestamp` number, float, required — The start timestamp in seconds relative to the start of the call.
    - `end_timestamp` number, float, required — The end timestamp in seconds relative to the start of the call.
    - `tool_calls` ToolCall[], nullable — The tool calls made during the turn.
      - `id` string — The unique identifier for the tool call.
      - `name` string, required — The name of the tool that was called.
      - `arguments` object, required — The arguments passed to the tool.
      - `result` string — The result returned by the tool.
    - `stt_ttfb` number, float, nullable — The time to first byte in seconds for speech-to-text.
    - `tts_ttfb` number, float, nullable — The time to first byte in seconds from the agent for text-to-speech.
    - `log_event` LogEvent
      - `event` string, required — The event name.
      - `metadata` object, required — Additional metadata associated with the event.
      - `timestamp` number, double, required — The timestamp when the event was received relative to the start of the call.
    - `log_metric` LogMetric
      - `name` string, required — The name of the metric.
      - `value` union, required — The value of the metric.
        - number, double
        - string
        - boolean
      - `timestamp` number, double, required — The timestamp when the metric was received relative to the start of the call.
  - `telephony_params` TelephonyParams — The telephony parameters associated with the call when the call is made via a phone. More details can also be returned depending on the provider.
    - `to` string — The phone number of the caller. Present for phone calls; omitted for websocket connections.
    - `from` string — The phone number of the agent. Present for phone calls; omitted for websocket connections.
    - `call_sid` string — The SID of the telephony call from the provider.
    - `direction` string — The direction of the call, e.g., `inbound` or `outbound`.
    - `parameters` object — Additional parameters associated with the telephony call.
    - `headers` object — Additional headers associated with the telephony call.
    - `connection_type` 'websocket' | 'phone' — The type of connection used for the call.
  - `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.
  - `summary` string, 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_message` string, 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_id` string, nullable — The deployment identifier associated with the call.
  - `deployment_version_id` string, nullable — The specific deployment version identifier associated with the call.
  - `deployment_region` 'US' | 'EU' | 'APAC', nullable — The deployment region that handled the call.
  - `metadata` object, nullable — Custom metadata associated with the call.

## Other responses

- `400` — Call is not in a terminal state. Only completed or failed calls can be deleted; cancel an active call first via `POST /agents/calls/{call_id}/cancel`.
- `404` — Call not found.
- `500` — Deletion did not complete. Retry the request; deletion is idempotent.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/versions/8910812440d3/schema)