删除部门
本接口用于删除部门。
Tip: 注意：
- 删除部门需要有待删除部门及其父部门的应用数据权限配置应用数据权限
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/directory/v1/departments/:department_id |
| HTTP Method | DELETE |
| 接口频率限制 | 10 次/秒 |
| 支持的应用类型 | custom |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | directory:department.delete:write 删除部门 directory:department:write 创建、更新、删除部门 |
| 字段权限要求 | > Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 directory:employee.base.external_id:read 查看员工自定义 ID |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
department_id | string | 部门ID，与department_id_type类型保持一致 示例值："weasdqwe" 数据校验规则： - 最大长度： 64 字符 |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
department_id_type | string | 否 | 此次调用中使用的部门ID的类型 示例值：open_department_id 可选值有： - department_id: 用来标识租户内一个唯一的部门 - open_department_id: 用来在具体某个应用中标识一个部门，同一个部门 在不同应用中的 open_department_id 不相同。默认值： open_department_id |
响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码，非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {}
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 2221332 | Department has members, can not delete department | 部门下还有在职、待入职雇员，不能删除部门 |
| 400 | 2224001 | No permission to operate | 无操作权限，请检查当前应用的权限或企业版本是否是商业专业版本及以上。 |
| 400 | 2224002 | No permission to operate record | 无操作该记录权限，请检查当前应用的数据管理范围的权限或当前应用所操作的部门是否可删除。 |
| 400 | 2224003 | No permission to operate dependent object | 无操作依赖对象权限，请检查要删除的部门是否有权限。 |
| 400 | 2221348 | Department has child, can not delete department | 部门下存在子部门，请先移动或删除子部门 |