删除部门

最近更新时间:2024-07-08 11:48:53

我的收藏

接口描述

描述:根据部门 ID 批量删除企业部门,仅企业下具有部门编辑权限的用户可删除部门,部门下存在子部门或部门下有成员则不可删除。不支持 OAuth2.0 鉴权访问。
请求方式:POST
自建应用权限点:管理企业部门。
接口请求域名
https://api.meeting.qq.com/v1/departments/remove


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
userid
String
接口调用者 userid,必须为企业下具有部门编辑权限的用户。
department_list
String数组
部门 ID 数组。

输出参数

成功输出空消息体,失败则返回 错误码 和错误信息。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
500
20003
部门下有子部门。
500
190443
用户无部门操作权限。场景:
1:用户无编辑部门信息权限
2:用户无查看部门信息权限

示例

输入示例

POST
https://api.meeting.qq.com/v1/departments/remove
{
"userid": "meeting4548079",
"department_list": ["e3ce08567893251f05db4de921fc2c2"]
}

输出示例

{}