删除用户组

DELETE

/contact/v3/group/{group_id}

通过该接口可删除企业中的用户组，请注意删除用户组时应用的通讯录权限范围需为“全部员工”，否则会删除失败，点击了解通讯录权限范围。

HTTP状态码	错误码	描述	排查建议
500	40003	internal error	内部错误，请提供 X-Request-Id向客服反馈。联系客服。
400	42002	invalid group_id	用户组 ID 无效
403	42009	no group authority	缺少用户组权限。应用的通讯录权限范围需包含该用户组或为“全部员工”，点击了解更多
400	42017	group has member not allow delete	用户组中还有成员，删除之前需先移除用户组成员
400	42015	user group disable	用户组功能未开启，请联系飞书客服处理，联系客服

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://open.feishu.cn/open-apis/contact/v3/group/g1837191' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

修改于 2025-10-20 09:20:17