更新部门

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

我的收藏

接口描述

描述:更新企业部门信息,仅企业下具有部门编辑权限的用户可更新部门。不支持 OAuth2.0 鉴权访问。
请求方式:PUT
自建应用权限点:管理企业部门。
接口请求域名
https://api.meeting.qq.com/v1/departments/{departmentId}


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
userid
String
接口调用者 userid,必须为企业下具有部门编辑权限的用户。
parent_department_id
String
上级部门 ID,若需要将部门变更为主部门,此字段传0。
department_name
String
部门名称,至少1个字符,长度不超过50个字符。

输出参数

成功输出以下字段,失败则返回 错误码 和错误信息。
参数名称
参数类型
参数描述
department_full_name
String
部门全称。
department_id
String
部门 ID。
department_name
String
部门名称。
is_main_department
Boolean
是否是主部门。
parent_department_id
String
上级部门 ID。
user_count
Integer
部门人数。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
500
20000
该企业部门信息不存在。
500
10013
部门信息不存在。

示例

输入示例

PUT
https://api.meeting.qq.com/v1/departments/e3ce08********1f05db4de921fc2c2d
{
"userid": "meeting4548079",
"department_name": "test-子部门-03",
"parent_department_id": "e3ce08****************e921fc2c2"
}

输出示例

{
"department_id": "a45edc92c****************c9eb537",
"department_name": "test-子部门-03",
"department_full_name": "test-主部门-01/test-子部门-03",
"is_main_department": false,
"user_count": 0,
"parent_department_id": "1519****************d9da464bf856"
}