跳到主要内容

更新部门

调用本接口,更新部门信息


权限说明​

仅支持专有轻流。

「超管accessToken」和「权限组accessToken」都可以调用,「权限组accessToken」须具有通讯录权限。

请求​

**请求方式:**POST

**请求地址:**http(s)://xxx.xx(自有域名)/openApi/department/:deptId

请求地址中:deptId为需要替换的变量,根据实际获取值更新,示例如下:

POST https://ncbd.qingflow.com/openApi/department/123456

参数说明(路径参数):​

参数必须说明
deptId是部门id,可通过文档接口获取

参数说明(查询参数):​

请求头(Header)​

参数必须说明
accessToken是调用接口凭证。获取方法请查看“文档”

请求体(Body)​

参数必须类型说明
deptId是int部门id,不可更改
name是string部门名称
parentIdint父部门id
deptLeaderarray部门主管的userId
ordinalint同级部门(同个父部门)中的顺序值,取值范围为0-2^30

请求体示例​

{
"deptId":123456,
"name":"产品2部",
"parentId":2263,
"deptLeader":["9054"]
}

返回​

返回体​

参数必含类型说明
errCode是int错误码,非0表示失败
errMsg是string错误描述
questionRelations关联的设置,这里没用
result是object返回结果
deptId是int部门id

返回体示例​

{
"errCode": 0,
"errMsg": null,
"questionRelations": [],
"result": {
"deptId": 123456
}
}

注意事项​

  • 平台型轻流(企微、飞书、钉钉版本)的同步部门不支持更新