修改子频道

修改子频道信息。需要管理员权限。

需要管理员权限。私域接口，只需传入要修改的字段，修改成功后会触发 CHANNEL_UPDATE 事件。

请求

基础信息

字段	值
HTTP URL	/channels/{channel_id}
HTTP Method	PATCH
接口频率限制	50 QPS

路径参数

名称	类型	必填	描述
channel_id	string	是

请求体

名称	类型	必填	描述
name	string	否	子频道名
position	integer	否	排序
parent_id	string	否	分组 ID
private_type	integer	否	私密类型
speak_permission	integer	否	发言权限

请求示例

修改子频道名称和排序

PATCH /channels/123456
{
  "name": "公告区（已改名）",
  "position": 5,
  "parent_id": "0"
}

响应

响应体

名称	类型	描述
id	string	子频道 ID
guild_id	string	所属频道 ID
name	string	子频道名
type	integer	子频道类型: 0=文字, 2=语音, 4=分组, 10005=直播, 10006=应用, 10007=论坛
sub_type	integer	子频道子类型（文字子频道）: 0=闲聊, 1=公告, 2=攻略, 3=开黑
position	integer	排序值，从 1 开始
parent_id	string	所属分组 ID（仅子频道有效）
owner_id	string	创建人 ID
private_type	integer	子频道私密类型: 0=公开, 1=群主管理员可见, 2=群主管理员+指定成员
speak_permission	integer	子频道发言权限: 0=无效, 1=所有人, 2=群主管理员+指定成员
application_id	string	应用子频道标识
permissions	string	用户拥有的子频道权限

响应示例

示例1

{
  "id": "123456",
  "guild_id": "123456789012345678",
  "name": "公告区（已改名）",
  "type": 0,
  "sub_type": 0,
  "position": 5,
  "parent_id": "0",
  "owner_id": "123456789012345678",
  "private_type": 0,
  "speak_permission": 1
}