删除部门

可以通过该接口通过部门ID删除一个部门记录，带数据行权限判权

Tip: 该接口为 V2 版本接口。要查看旧版 V1 接口，参考：【删除部门】

Error: 删除后无法恢复， 并且在系统中无法查看到对应部门信息，请谨慎操作。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/departments/:department_id
HTTP Method	DELETE
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	corehr:corehr 更新核心人事信息 corehr:department:write 读写部门信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

路径参数

名称	类型	描述
department_id	string	需要删除的部门 ID，可通过【搜索部门信息】接口查询获得 示例值："1616161616"

查询参数

名称	类型	必填	描述
department_id_type	string	否	此次调用中使用的部门 ID 类型 示例值：open_department_id 可选值有： - open_department_id: 【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同。 - department_id: 【飞书】用来标识租户内一个唯一的部门。 - people_corehr_department_id: 【飞书人事】用来标识「飞书人事」中的部门。 默认值：open_department_id

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
400	1160265	Unable to delete department as it's still in use	请确认该部门是否仍在使用，若在使用请先停用后再尝试删除