---
title: "Leave a conference"
method: POST
path: "/conferences/{id}/actions/leave"
tags: ["Conference Commands"]
---

# Leave a conference

`POST /conferences/{id}/actions/leave`

Removes a call leg from a conference and moves it back to parked state. 

**Expected Webhooks:**

- `conference.participant.left`

## Path parameters

- `id` string, required

## Request body

- LeaveConferenceRequest
  - `call_control_id` string, required — Unique identifier and token for controlling the call
  - `command_id` string — Use this field to avoid execution of duplicate commands. Telnyx will ignore subsequent commands with the same `command_id` as one that has already been executed.
  - `beep_enabled` 'always' | 'never' | 'on_enter' | 'on_exit' — Whether a beep sound should be played when the participant leaves the conference. Can be used to override the conference-level setting.
  - `region` 'Australia' | 'Europe' | 'Middle East' | 'US' — Region where the conference data is located. Defaults to the region defined in user's data locality settings (Europe or US).

## Response `200`

Successful response upon making a conference command.

- object
  - `data` ConferenceCommandResult
    - `result` string, required

## Other responses

- `401` — Unauthorized. Authentication failed - the required authentication headers were either invalid or not included in the request.
- `422` — Unprocessable entity. The request was well-formed but could not be processed due to semantic errors. This includes validation errors, invalid parameter values, call state errors, conference errors, queue errors, recording/transcription errors, and business logic violations.

---

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