---
title: "Start recording"
method: POST
path: "/calls/1/dialogs/{dialogId}/start-recording"
tags: ["channels", "voice", "calls", "dialog-calls", "dialog-operations"]
---

# Start recording

`POST /calls/1/dialogs/{dialogId}/start-recording`

## 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/dialogs/{dialogId}/start-recording`
- 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`

Start recording a dialog.

## Path parameters

- `dialogId` string, required

## Request body

- 14b5f31f4f292db4a32c4e61928f9a47f8ff4c0a1c06a38af2c29ef9ca05095dDialogRecordingRequest
  - `recordingType` 'AUDIO' | 'AUDIO_AND_VIDEO', required: Recording type.
  - `dialogComposition` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611DialogRecordingComposition
    - `enabled` boolean: Indicates whether to create a single recording of both participants. If set to `true`, both participants are merged into a single audio or video file. Otherwise, both participants will have their own individual audio or video file.
  - `customData` object: Custom data.
  - `filePrefix` string: Custom name for the recording's zip file. Applicable only when SFTP server is enabled on [Voice settings page](https://portal.infobip.com/apps/voice/recording/settings). Using the same filePrefix will override the files on the SFTP server. For recordings without composition, `callId` and `fileId` will be appended to the `filePrefix` value.

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