---
title: "Start recording"
method: POST
path: "/calls/1/conferences/{conferenceId}/start-recording"
tags: ["channels", "voice", "calls", "conference-calls", "conference-operations"]
---

# Start recording

`POST /calls/1/conferences/{conferenceId}/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/conferences/{conferenceId}/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 conference.

## Path parameters

- `conferenceId` string, required

## Request body

- 4811a3a9108d5f90b8934012403f954f20270c436bdecbc318a80214cf54fc02ConferenceRecordingRequest
  - `recordingType` 'AUDIO' | 'AUDIO_AND_VIDEO', required: Recording type.
  - `conferenceComposition` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611ConferenceComposition
    - `enabled` boolean: Indicates whether to create a single recording of all participants. If set to `True`, all participants are merged into a single audio or video file. Otherwise, all 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 recording 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)