> ## 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. # 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`. ## OpenAPI ````yaml /latest.yml DELETE /agents/calls/{call_id} openapi: 3.0.1 info: title: Cartesia API version: 0.0.1 servers: - url: https://api.cartesia.ai description: Production security: [] paths: /agents/calls/{call_id}: delete: tags: - Agents summary: Delete Call description: >- 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`. operationId: agents_delete-call parameters: - $ref: '#/components/parameters/CartesiaVersionHeader' - name: call_id in: path description: The ID of the call. required: true schema: type: string responses: '200': description: The call record with sensitive fields deleted. content: application/json: schema: $ref: '#/components/schemas/AgentCall' example: id: ac_abc123 agent_id: agent_abc123 agent_name: Customer support zdr_enabled: false redacted_at: '2026-03-01T12:30:00Z' start_time: '2026-03-01T12:00:00Z' end_time: '2026-03-01T12:05:00Z' telephony_params: call_sid: sid_abc123 connection_type: websocket status: completed end_reason: agent_hangup deployment_id: ad_abc123 deployment_version_id: av_abc123 deployment_region: US '400': description: >- 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': description: Call not found. '500': description: >- Deletion did not complete. Retry the request; deletion is idempotent. security: - APIKeyAuth: [] components: parameters: CartesiaVersionHeader: name: Cartesia-Version in: header description: API version header. required: true schema: type: string format: date example: '2026-03-01' enum: - '2026-03-01' schemas: AgentCall: title: AgentCall type: object properties: id: type: string description: The unique identifier for the agent call. agent_id: type: string description: The identifier of the agent associated with the call. agent_name: type: string description: The name of the agent associated with the call. zdr_enabled: type: boolean description: >- 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: type: string format: date-time nullable: true description: The start time of the agent call. end_time: type: string format: date-time nullable: true description: The end time of the agent call. redacted_at: type: string format: date-time nullable: true description: >- 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: type: array items: $ref: '#/components/schemas/AgentTranscript' nullable: true description: The transcript of the agent call. telephony_params: $ref: '#/components/schemas/TelephonyParams' nullable: true description: >- The telephony parameters associated with the call when the call is made via phone. telephony_account_type: type: string enum: - cartesia - twilio - sip_trunk nullable: true description: >- 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: type: string nullable: true description: >- A summary of the agent call. This is a brief summary of the call that is generated by Cartesia. status: $ref: '#/components/schemas/AgentCallStatus' description: The status of the agent call. error_message: type: string nullable: true description: The error message, if any, associated with the call. end_reason: $ref: '#/components/schemas/EndReason' nullable: true description: The reason why the call ended. deployment_id: type: string nullable: true description: The deployment identifier associated with the call. deployment_version_id: type: string nullable: true description: The specific deployment version identifier associated with the call. deployment_region: type: string enum: - US - EU - APAC nullable: true description: The deployment region that handled the call. metadata: type: object additionalProperties: true nullable: true description: Custom metadata associated with the call. required: - id - agent_id - status AgentTranscript: title: AgentTranscript type: object properties: role: type: string description: >- 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: type: string nullable: true description: >- The text content of the transcript. This is the text that was spoken by the user or the agent. start_timestamp: type: number format: float description: The start timestamp in seconds relative to the start of the call. end_timestamp: type: number format: float description: The end timestamp in seconds relative to the start of the call. tool_calls: type: array items: $ref: '#/components/schemas/ToolCall' nullable: true description: The tool calls made during the turn. stt_ttfb: type: number format: float nullable: true description: The time to first byte in seconds for speech-to-text. tts_ttfb: type: number format: float nullable: true description: The time to first byte in seconds from the agent for text-to-speech. log_event: $ref: '#/components/schemas/LogEvent' nullable: true description: The log event from agent code. log_metric: $ref: '#/components/schemas/LogMetric' nullable: true description: The log metric from agent code. required: - role - start_timestamp - end_timestamp TelephonyParams: title: TelephonyParams type: object description: >- 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. properties: to: type: string description: >- The phone number of the caller. Present for phone calls; omitted for websocket connections. from: type: string description: >- The phone number of the agent. Present for phone calls; omitted for websocket connections. call_sid: type: string description: The SID of the telephony call from the provider. direction: type: string description: The direction of the call, e.g., `inbound` or `outbound`. parameters: type: object additionalProperties: type: string description: Additional parameters associated with the telephony call. headers: type: object additionalProperties: type: string description: Additional headers associated with the telephony call. connection_type: type: string enum: - websocket - phone description: The type of connection used for the call. AgentCallStatus: title: AgentCallStatus type: string enum: - created - started - completed - failed description: The status of an agent call. EndReason: title: EndReason type: string enum: - agent_hangup - client_hangup - api_cancelled - max_duration - inactivity - client_disconnected - dial_busy - dial_failed - dial_no_answer - error description: A machine-readable enum indicating why a call ended. ToolCall: title: ToolCall type: object properties: id: type: string description: The unique identifier for the tool call. name: type: string description: The name of the tool that was called. arguments: type: object additionalProperties: true description: The arguments passed to the tool. result: type: string description: The result returned by the tool. required: - name - arguments LogEvent: title: LogEvent type: object properties: event: type: string description: The event name. metadata: type: object additionalProperties: type: string description: Additional metadata associated with the event. timestamp: type: number format: double description: >- The timestamp when the event was received relative to the start of the call. required: - event - metadata - timestamp LogMetric: title: LogMetric type: object properties: name: type: string description: The name of the metric. value: description: The value of the metric. oneOf: - type: number format: double - type: string - type: boolean timestamp: type: number format: double description: >- The timestamp when the metric was received relative to the start of the call. required: - name - value - timestamp securitySchemes: APIKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- Cartesia API key (`sk_car_...`). Get one at [play.cartesia.ai/keys](https://play.cartesia.ai/keys). ````