修改子频道

接口

PATCH /channels/{channel_id}

功能描述

用于修改 channel_id 指定的子频道的信息。

• 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。
• 修改成功后，会触发子频道更新事件。

注意

• 公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
• 注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

参数

字段名	类型	描述
name	string	子频道名
position	int	排序
parent_id	string	分组 id
private_type	int	子频道私密类型 PrivateType
speak_permission	int	子频道发言权限 SpeakPermission

需要修改哪个字段，就传递哪个字段即可。

返回

返回Channel 对象。

错误码

详见错误码。

示例

请求数据包

{
  "name": "新的私密子频道",
  "position": 1,
  "owner_id": "0",
  "sub_type": 0,
  "private_type": 1
}

响应数据包

{
  "id": "xxxxxx",
  "guild_id": "xxxxxx",
  "name": "私密子频道a",
  "type": 10006,
  "position": 2,
  "parent_id": "xxxxxx",
  "owner_id": "xxxxxx",
  "sub_type": 0,
  "private_type": 1
}