删除部门

DELETE

/open-apis/contact/v3/departments/{department_id}

自建应用

该接口用于向通讯录中删除部门。
应用需要同时拥有待删除部门及其父部门的通讯录授权。应用商店应用无权限调用该接口。

错误码

HTTP状态码	错误码	描述	排查建议
400	43011	delete has member dept error	待删除的部门下不能包含用户，请检查部门中是否还有未删除的用户。
400	43012	delete has sub dept department error	待删除的部门下不能包含部门，请检查部门中是否还有未删除的子部门。
400	40002	process root dept error	不能对根部门进行移除部门群处理
400	40003	internal error	内部错误，请提供 X-Request-Id向客服反馈。联系客服。
403	40004	no dept authority error	操作的部门需在通讯录权限范围中，了解更多
403	40014	no parent dept authority error	没有父部门权限（组织架构可见范围权限）。
401	42008	tenant id is invalid error	请检查请求租户是否为合法租户。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://open.feishu.cn/open-apis/contact/v3/departments/od-4e6ac4d14bcd5071a37a39de902c7141?department_id_type=open_department_id' \
--header 'Authorization;'

响应示例

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

请求参数

Path 参数

department_id

必需

部门ID，需要与查询参数中传入的department_id_type类型保持一致。示例值："od-4e6ac4d14bcd5071a37a39de902c7141" 数据校验规则：最大长度：64 字符正则校验：^0|[^od][A-Za-z0-9]*

示例值:

od-4e6ac4d14bcd5071a37a39de902c7141

Query 参数

department_id_type

必需

此次调用中使用的部门ID的类型示例值："open_department_id"可选值有：department_id：以自定义department_id来标识部门open_department_id：以open_department_id来标识部门默认值：open_department_id

示例值:

open_department_id

Header 参数

Authorization

string

必需

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

默认值:

Bearer {{access_token}}

返回响应

🟢200200 Success

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

修改于 2023-01-12 05:48:53

创建部门

修改部门部分信息

删除部门

错误码#

请求参数

返回响应

错误码