若关闭聊天室后需要再次开启，创建者也可以调用此接口重新开放聊天室，该接口还可以设置聊天室定时关闭策略。

功能描述

创建聊天室后，聊天室默认处于开放状态，所有用户可自由进入聊天室。如需暂停所有用户可自由进入聊天室的权限，创建者可通过调用本服务端 API 关闭聊天室。

如果关闭聊天室，那么聊天室中所有在线成员将被强制踢下线。

调用频率

单个应用默认最高调用频率请参考 频控说明。

请求信息

请求 URL

PATCH https://{endpoint}/im/v2/chatrooms/{room_id}/actions/update_status

请求 URL 中的 {endpoint} 代表服务地址域名，您可以根据用户服务区域选择中国大陆和海外服务地址，并支持搭建高可用主备域名机制。详情请参考 调用方式 服务地址章节。

请求头参数

请求 Header 的参数说明请参考 请求 Header。

路径参数

参数名称	类型	是否必选	描述
room_id	Long	是	需要开放/关闭的聊天室 ID，聊天室创建成功后，网易云信会返回聊天室 ID。

请求体参数

参数名称	类型	是否必选	描述
operator_account_id	String	是	操作者（聊天室创建者）的 IM 账号 ID。
valid	Boolean	是	是否开放聊天室，true（默认）：开放；false：关闭。
delay_close_policy	Integer	否	聊天室定时关闭方式。 0：不开启定时关闭；1：固定时间关闭（不管聊天室中是否还有用户）；2：空闲关闭（等聊天室中没有用户后固定时间关闭）。 如果需要使用聊天室定时关闭功能（聊天室自动销毁机制），需要先在 网易云信控制台 开启（具体请参考 开通和配置聊天室功能）。 开启该功能后，自动销毁机制的策略可以直接通过该字段进行配置，也可以在 网易云信控制台 配置（优先以该参数传入的策略为准，若未传入该参数，则以控制台配置的策略为准）。 仅该功能开通后创建的聊天室支持定时关闭，开通前创建的聊天室不支持定时关闭。
delay_seconds	Long	否	聊天室定时关闭的时间，单位秒，最大值为 7x24x3600 秒。 当不开启定时关闭功能（delay_close_policy = 0）时，该参数不生效。 当选择固定时间关闭或空闲关闭策略时（delay_close_policy = 1 或 2）： 若该参数不为空，则以传入的定时时间为准； 若未传入该参数，则以控制台的定时时间为准。

请求体示例

JSON{
    "valid": true,
    "delay_seconds": 604800,
    "operator_account_id": "yx1",
    "delay_close_policy": 2
}

响应信息

响应头参数

响应 Header 的参数说明请参考 响应 Header。

响应体参数

参数名称	类型	说明	是否必返回
code	Integer	状态码，200 表示请求成功。	是
msg	String	提示信息。请求失败时返回错误信息，请求成功时返回 "success"。	是
- data	Object	返回的 JSON 数据对象，请求失败则返回空对象。	是
valid	Boolean	聊天室状态。true：开放；false：关闭。	是
creator	String	聊天室创建者。	是
room_name	String	聊天室名称。	是
announcement	String	聊天室公告。	否
live_url	String	直播地址。	否
extension	String	自定义扩展字段。	否
chat_banned	Boolean	聊天室是否处于全体禁言状态，全体禁言时仅管理员和创建者可以发言，false：未禁言，true：禁言。	是
room_id	Long	聊天室 ID。	是
queue_level	Integer	聊天室队列管理权限。0：所有人都有权限变更队列；1：只有管理员才能变更队列。	是
- delay_info	Object	聊天室定时关闭的相关信息。	否
status	Integer	定时关闭状态码。	是
delay_seconds	Long	聊天室定时关闭的时间，单位秒。	是
delay_close_enable	Boolean	是否启用定时关闭功能。true：启用；false：不启用。	是
start_time	Long	定时关闭的开始时间戳，单位毫秒。	是
delay_close_policy	Integer	聊天室定时关闭方式。0：不开启定时关闭；1：固定时间关闭；2：空闲关闭。	是

响应体示例

JSON{
  "code": 200,
  "msg": "success",
  "data": {
    "valid": true,
    "extension": "聊天室自定义消息 002",
    "creator": "test",
    "announcement": "announcement",
    "room_name": "test-room-78",
    "chat_banned": false,
    "live_url": "broadcast_url",
    "room_id": 11658335223,
    "queue_level": 0,
    "delay_info": {
      "status": 2,
      "delay_seconds": 2000,
      "delay_close_enable": true,
      "start_time": 1752741163002,
      "delay_close_policy": 1
    }
  }
}

错误码

本文仅列举部分业务接口错误码，完整列表请参考客户端 API 错误码。

错误码	错误码描述	错误信息示例
200	请求成功	success
414	参数错误	parameter error
416	频率超限	rate limit exceeded
113303	聊天室正在关闭，不允许重新开启	chat room closing, reopen not allowed
113410	聊天室服务未开通	chatroom service disabled
113409	聊天室重复操作	operation on chatroom repeated
113404	聊天室不存在	chatroom not exist
113406	聊天室已关闭	chatroom closed
113434	聊天室数量超过限制	chatroom count limit exceeded
500	服务端内部错误	internal server error
503	服务器繁忙	server busy