---
title: "Delete a call recording"
method: DELETE
path: "/recordings/{recording_id}"
tags: ["Call Recordings"]
---

# Delete a call recording

`DELETE /recordings/{recording_id}`

Permanently deletes a call recording.

## Path parameters

- `recording_id` string, required

## Response `200`

A response with a single recording resource.

- RecordingResponse
  - `data` RecordingResponseData
    - `call_control_id` string — Unique identifier and token for controlling the call.
    - `call_leg_id` string — ID unique to the call leg (used to correlate webhook events).
    - `call_session_id` string — ID that is unique to the call session and can be used to correlate webhook events. Call session is a group of related call legs that logically belong to the same phone call, e.g. an inbound and outbound leg of a transferred call.
    - `channels` 'single' | 'dual' — When `dual`, the final audio file has the first leg on channel A, and the rest on channel B.
    - `conference_id` string — Uniquely identifies the conference.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `download_urls` object — Links to download the recording files.
      - `mp3` string — Link to download the recording in mp3 format.
      - `wav` string — Link to download the recording in wav format.
    - `duration_millis` integer — The duration of the recording in milliseconds.
    - `id` string — Uniquely identifies the recording.
    - `record_type` 'recording'
    - `recording_started_at` string — ISO 8601 formatted date of when the recording started.
    - `recording_ended_at` string — ISO 8601 formatted date of when the recording ended.
    - `source` 'conference' | 'call' — The kind of event that led to this recording being created.
    - `status` 'completed' — The status of the recording. Only `completed` recordings are currently supported.
    - `from` string — The `from` (caller) number for the call that generated this recording.
    - `to` string — The `to` (callee) number for the call that generated this recording.
    - `connection_id` string — Identifies the Telnyx application (Call Control, TeXML) or SIP connection resource associated with this recording.
    - `initiated_by` string — Indicates what triggered the recording. Possible values include `DialVerb`, `Conference`, `OutboundAPI`, `Trunking`, `RecordVerb`, `StartCallRecordingAPI`, `StartConferenceRecordingAPI`.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `401` — Unauthorized. The request lacks valid authentication credentials.
- `404` — Resource not found. The requested resource or URL could not be found.
- `default` — Unexpected error.

---

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