- 应用权限
- API 调用指南
- 事件与回调
- 服务端 SDK
- 认证及授权
- 通讯录
- 事件管理
- 消息
- 群组
- 云文档
- 日历
- 视频会议
- 考勤打卡
- 审批
- 服务台
- 任务
- 邮箱
- 应用信息
- 企业信息
- 认证信息
- 个人设置
- 搜索
- AI 能力
- 管理后台
- 飞书人事（标准版）
- 飞书人事（企业版）
- 招聘
- OKR
- 实名认证
- 智能门禁
- 企业百科
- 妙记
- 工作台
- 企业
- 数据模型
更新用户组
PATCH
/contact/v3/group/{group_id}
错误码#
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 500 | 40003 | internal error | 内部错误，请提供 X-Request-Id向客服反馈。联系客服。 |
| 400 | 42002 | invalid group_id | 用户组 ID 无效 |
| 400 | 42013 | group name exceed limit | 用户 组名字长度超过最大限制，最大限制100字符 |
| 400 | 42014 | group description exceed limit | 用户组描述长度超过最大限制，最大限制500字符 |
| 403 | 42009 | no group authority | 缺少用户组权限。应用的通讯录权限范围需包含该用户组或为“全部员工”，点击了解更多 |
| 400 | 42015 | user group disable | 用户组功能未开启，请联系飞书客服处理，联系客服 |
| 400 | 47009 | duplicated name error | 用户组名称不得在企业内重复 |
请求参数
Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************or
Path 参数
Body 参数application/json
示例
返回响应
🟢200成功
application/json
Body
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://open.feishu.cn/open-apis/contact/v3/group/g187131' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "外包 IT 用户组",
"description": "IT 外包用户组，需要进行细粒度权限管控"
}'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {}
}
【飞书】API开发者 微信交流群
用微信扫右侧二维码，加入【飞书】API开发者 交流群，互助沟通
扫码加入交流群修改于 2025-10-20 09:20:33