---
title: "Leave a channel"
method: PUT
path: "/v3/group_channels/{channel_url}/leave"
tags: ["Group channel"]
---

# Leave a channel

`PUT /v3/group_channels/{channel_url}/leave`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/group_channels/{channel_url}/leave`
- Auth: none declared

## Leave a channel

Makes one or more members leave a group channel.

https://sendbird.com/docs/chat/v3/platform-api/guides/group-channel#2-leave-a-channel
----------------------------

## Path parameters

- `channel_url` string, required

## Headers

- `Api-Token` string

## Request body

- LeaveAChannelRequest
  - `user_ids` string[], required: Specifies an array of one or more IDs of the users to leave the channel.
  - `should_leave_all` boolean: Determines whether to make all members leave the channel. (Default: false)
  - `should_remove_operator_status` boolean: Determines whether to remove a user from the channel's operator list if the user who is leaving the channel is an operator. (Default: false)
  - `reason` 'LEFT_BY_OWN_CHOICE' | 'CHANNEL_OPERATOR_REMOVED' | 'ADMIN_REMOVED' | 'ADMIN_DELETED' | 'ADMIN_DEACTIVATED': Specifies the reason for leaving a channel. Acceptable values are admin_removed, admin_deleted, admin_deactivated, left_by_own_choice, and channel_operator_removed.

## Response `200`

Successful response

- EmptyObjectResponse

## Changes

- **2025-07-27** `7a85bad03e90`: 2 warning, 4 info
  - removed the request property `channel_url`
  - removed the optional property `anyOf` from the response with the `200` status
  - api operation id `gcLeaveChannel` removed and replaced with `leaveAChannel`
  - added the new optional request property `reason`
  - …2 more
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-07-27** `0b6cf41bc62a`: 1 breaking
  - the `user_ids/items/` request property type changed from `integer` to `string`
- **2022-05-03** `5299c01f7f16`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2022-02-16** `c42164095c7c`: 1 breaking
  - the `header` request parameter `Api-Token` became required

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/group_channels/:channel_url/leave/put.md)

---

[API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [All operations](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/revisions/9e53a5288df0?raw)