# 修改频道身份组

# 接口

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

# 功能描述

用于修改频道 guild_idrole_id 指定的身份组。

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

# Content-Type

application/json
1

# 参数

字段名 类型 描述
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"
}
1
2
3
4
5

响应数据包

{
  "guild_id": "3489223429684602178",
  "role_id": "10177739",
  "role": {
    "id": "10177739",
    "name": "test",
    "color": 99999,
    "hoist": 1,
    "number": 1,
    "member_limit": 2000
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
手机QQ扫码
开发者社区
加入官方频道开发者社区