删除用户组

DELETE

/open-apis/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	用户组功能未开启，请联系飞书客服处理，联系客服

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

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

请求参数

Path 参数

group_id

string

必需

需删除的用户组ID 示例值："g1837191"

示例值:

g1837191

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

可选

创建用户组

更新用户组

删除用户组

错误码#

请求参数

返回响应

错误码