docs-web-logo
开发文档

更新用户组

调用该接口更新指定用户组的信息，可以修改用户组的名称和描述。

注意事项

  • 用户组名称长度不能超过40个字符
  • 描述长度不能超过256个字符
  • 只更新传入的参数，未传入的参数保持不变

请求

基本
请求方式PATCH
请求地址/openapi/v3/contacts/groups/:group_id

请求头

名称类型必填描述
Authorizationstring是值格式：Bearer {{access_token}}

调用 API 时，需要通过访问凭证（access_token）进行身份鉴权，不同类型的访问凭证可获取的数据范围不同，参考 获取访问凭证 。

支持鉴权类型：
• 应用级token：以应用身份调用 API，校验应用的数据访问范围。参考 获取企业内部应用access_token。
• 用户级token：以登录用户身份调用 API，校验用户的可见数据范围。参考 获取登录用户access_token。
Content-Typestring是固定值：application/json; charset=utf-8

路径参数

名称类型必填描述
group_idstring是用户组id

请求体

名称类型必填描述
namestring否名字，长度不超过40个字符
descriptionstring否描述，长度不超过256个字符

请求体示例

  1{
  2  "name": "技术研发中心",
  3  "description": "负责公司核心技术研发和创新"
  4}

响应

响应体

  1{
  2  "code": 0,
  3  "msg": "success"
  4}