---
title: "Delete recording"
method: DELETE
path: "/markuplanguage/1/recordings"
tags: ["channels", "voice", "calls-markup-language", "calls-markup-language-recordings"]
---

# Delete recording

`DELETE /markuplanguage/1/recordings`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/markuplanguage/1/recordings`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

This method allows deleting Calls Markup Language recordings based on markup recording ID.

## Query parameters

- `markupRecordingId` string, required
- `location` 'SAO_PAULO' | 'BOGOTA' | 'FRANKFURT' | 'JOHANNESBURG' | 'JOHANNESBURG_1' | 'NEW_YORK' | 'PORTLAND' | 'MOSCOW' | 'SINGAPORE' | 'ISTANBUL' | 'KUALA_LUMPUR' | 'JAKARTA' | 'MUMBAI' | 'HONG_KONG_1' | 'HONG_KONG' | 'RIYADH' | 'CHENNAI'

## Response `200`

Success

- 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eMarkupLanguageRecordingApiResponse: Calls Markup Language recording API response.
  - `application` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8CallsMarkupLanguageApplication, required: Application data for the recording.
    - `type` 'CALLS_MARKUP_LANGUAGE': Application type.
    - `markupRecordingId` string: Markup language recording identifier.
    - `callId` string: Call identifier.
    - `dialogId` string: Dialog identifier.
    - `markupUrl` string: Markup URL used to initiate the call.
    - `startTime` string, date-time: Start time of the call.
    - `endTime` string, date-time: End time of the call.
  - `recording` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eRecordingMetadata, required: Recording metadata
    - `composedFiles` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eRecordedFile[]: Composed recording files.
      - `id` string: File ID.
      - `name` string: File name.
      - `fileFormat` 'MP3' | 'WAV' | 'MP4': File format.
      - `size` integer: File size in bytes.
      - `startTime` string, date-time: Date and time when the recording started.
      - `endTime` string, date-time: Date and time when the recording ended.
      - `creationTime` string, date-time: File creation time.
      - `duration` integer: File duration in seconds.
      - `location` 'UPLOADING' | 'UPLOADED' | 'HOSTED': Location of recording file after processing.
      - `customData` object: Client-defined data.
    - `callRecordings` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eCallRecording[]: Call recording data.
      - `callId` string: Call identifier.
      - `endpoint` string: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls.
      - `direction` 'INBOUND' | 'OUTBOUND': Call direction.
      - `status` string: Status of call recording.
      - `reason` string: Reason for recording failure.
      - `files` 6ee61eb40f9e4619d309dfe8df9b479488b43bcde7df95f6a044b2e14abf591eRecordedFile[]: Recording files.
        - `id` string: File ID.
        - `name` string: File name.
        - `fileFormat` 'MP3' | 'WAV' | 'MP4': File format.
        - `size` integer: File size in bytes.
        - `startTime` string, date-time: Date and time when the recording started.
        - `endTime` string, date-time: Date and time when the recording ended.
        - `creationTime` string, date-time: File creation time.
        - `duration` integer: File duration in seconds.
        - `location` 'UPLOADING' | 'UPLOADED' | 'HOSTED': Location of recording file after processing.
        - `customData` object: Client-defined data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)