---
title: "Freeze an open channel"
method: PUT
path: "/v3/open_channels/{channel_url}/freeze"
tags: ["Moderation"]
---

# Freeze an open channel

`PUT /v3/open_channels/{channel_url}/freeze`

## Request

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

## Freeze an open channel

Freezes or unfreezes an open channel.

> **Note**: To learn more about other available moderation tools, see [Moderation Overview](https://sendbird.com/docs/chat/platform-api/v3/moderation/moderation-overview#2-actions). 
  

[https://sendbird.com/docs/chat/platform-api/v3/moderation/freezing-a-channel/freeze-an-open-channel#1-freeze-an-open-channel](https://sendbird.com/docs/chat/platform-api/v3/moderation/freezing-a-channel/freeze-an-open-channel#1-freeze-an-open-channel)

## Path parameters

- `channel_url` string, required

## Headers

- `api-token` string

## Request body

- FreezeAnOpenChannelRequest
  - `freeze` boolean, required: Determines whether to freeze the channel. (Default: true)

## Response `200`

Successful response

- FreezeAnOpenChannelResponse
  - `channel_url` string, required
  - `cover_url` string
  - `created_at` integer
  - `custom_type` string
  - `data` string
  - `freeze` boolean
  - `is_dynamic_partitioned` boolean
  - `is_ephemeral` boolean
  - `max_length_message` integer
  - `name` string
  - `operators` SendbirdBasicUserInfo[]
    - `require_auth_for_profile_image` boolean
    - `is_active` boolean
    - `is_blocked_by_me` boolean
    - `role` '' | 'none' | 'operator'
    - `nickname` string, nullable
    - `user_id` string, required
    - `profile_url` string
    - `metadata` object, nullable
  - `participant_count` integer
  - `metadata` object, nullable

## Changes

- **2025-07-27** `7a85bad03e90`: 2 warning, 2 info
  - deleted the `header` request parameter `Api-Token`
  - removed the request property `channel_url`
  - api operation id `ocFreezeChannel` removed and replaced with `freezeAnOpenChannel`
  - added the new optional `header` request parameter `api-token`
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-06-29** `4012275aa67d`: 2 info
  - api tag `Moderation` added
  - api tag `Open channel` removed
- **2022-02-16** `c42164095c7c`: 1 breaking
  - the `header` request parameter `Api-Token` became required
- **2022-02-10** `a6ec75cbd9fb`: 1 breaking, 11 warning
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `channel_url` from the response with the `200` status
  - removed the optional property `cover_url` from the response with the `200` status
  - removed the optional property `created_at` from the response with the `200` status
  - …8 more

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/open_channels/:channel_url/freeze/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)