---
title: "Compose dialog recording on calls"
method: POST
path: "/calls/1/recordings/dialogs/{dialogId}/compose"
tags: ["channels", "voice", "calls", "files-and-recordings", "recording-operations"]
---

# Compose dialog recording on calls

`POST /calls/1/recordings/dialogs/{dialogId}/compose`

## 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/calls/1/recordings/dialogs/{dialogId}/compose`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Compose dialog recording on calls. Both calls will be merged into a single audio or video file.

## Path parameters

- `dialogId` string, required

## Query parameters

- `location` 'SAO_PAULO' | 'BOGOTA' | 'FRANKFURT' | 'JOHANNESBURG' | 'NEW_YORK' | 'PORTLAND' | 'MOSCOW' | 'SINGAPORE' | 'ISTANBUL' | 'KUALA_LUMPUR' | 'JAKARTA' | 'MUMBAI' | 'HONG_KONG' | 'RIYADH' | 'CHENNAI'

## Request body

- 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611OnDemandComposition: Composition request.
  - `deleteCallRecordings` boolean: Indicates whether to delete individual files for the call recordings after composition. If set to 'true' then files from the call recordings will be deleted after composition. Otherwise, files from the call recordings will be available, alongside with composed file.
  - `multiChannel` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MultiChannel: Multi-channel configuration. If enabled, audio of each participant will be in a separate channel in the composed file. Otherwise, audio of all participants will be mixed into a single channel in the composed file.
    - `enabled` boolean, required

## Response `200`

Success

- 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611ActionResponse
  - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': Action status.

## 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)