---
title: "Leave my group channels"
method: PUT
path: "/v3/users/{user_id}/my_group_channels/leave"
tags: ["User"]
---

# Leave my group channels

`PUT /v3/users/{user_id}/my_group_channels/leave`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/users/{user_id}/my_group_channels/leave`
- Auth: none declared

## Leave my group channels

This action allows a user to leave all group channels or channels with a specific custom type. This API is useful if you want to let a user leave a set of channels at once. To let a user leave only one of their group channels, use the [leave a channel API](https://sendbird.com/docs/chat/platform-api/v3/channel/managing-a-channel/leave-a-channel) instead.

Since this API can't be called for a deactivated user, ensure that the [<code>leave_all_when_deactivated</code>](https://sendbird.com/docs/chat/platform-api/v3/user/managing-users/update-a-user#2-request-body) property of the user is set to its default value of `true` to let the user leave all joined group channels upon deactivation.

https://sendbird.com/docs/chat/platform-api/v3/user/managing-joined-group-channels/leave-group-channels#1-leave-group-channels

`user_id`  
Type: string  
Description: Specifies the unique ID of the user to leave all joined group channels.

## Path parameters

- `user_id` string, required

## Headers

- `api-token` string

## Request body

- LeaveMyGroupChannelsRequest
  - `custom_type` string

## Response `200`

Successful response

- EmptyObjectResponse

## Changes

- **2025-07-27** `7a85bad03e90`: 1 warning, 2 info
  - deleted the `header` request parameter `Api-Token`
  - added the new optional `header` request parameter `api-token`
  - the request property `custom_type` became optional
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-07-27** `0b6cf41bc62a`: 1 warning
  - removed the request property `user_id`
- **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/users/:user_id/my_group_channels/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)