修改频道身份组

接口

PATCH /guilds/{guild_id}/roles/{role_id}

功能描述

用于修改频道 guild_id 下 role_id 指定的身份组。

• 需要使用的 token 对应的用户具备修改身份组权限。如果是机器人，要求被添加为管理员。
• 接口会修改传入的字段，不传入的默认不会修改，至少要传入一个参数。

Content-Type

application/json

参数

字段名	类型	描述
name	string	名称(非必填)
color	uint32	ARGB 的 HEX 十六进制颜色值转换后的十进制数值(非必填)
hoist	int32	在成员列表中单独展示: 0-否, 1-是(非必填)

返回

字段名	类型	描述
guild_id	string	频道 ID
role_id	string	身份组 ID
role	Role 对象	修改后的频道身份组对象

错误码

详见错误码。

示例

请求数据包

{
  "name": "test",
  "color": 99999,
  "hoist": "1"
}

响应数据包

{
  "guild_id": "3489223429684602178",
  "role_id": "10177739",
  "role": {
    "id": "10177739",
    "name": "test",
    "color": 99999,
    "hoist": 1,
    "number": 1,
    "member_limit": 2000
  }
}