更新部门

POST

https://qyapi.weixin.qq.com/cgi-bin/department/update

服务端API企业内部开发第三方应用开发智慧硬件开发

权限说明：
应用须拥有指定部门的管理权限。如若要移动部门，需要有新父部门的管理权限。
第三方仅通讯录应用可以调用。

注意，部门的最大层级为15层；部门总数不能超过3万个；每个部门下的节点不能超过3万个。

文档ID: 10077
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90206
https://open.work.weixin.qq.com/api/doc/90001/90143/90342
https://open.work.weixin.qq.com/api/doc/90002/90151/90825

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/department/update?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"id":2,"name":"广州研发中心","name_en":"RDGZ","parentid":1,"order":1}'

响应示例

{
  "errcode": 0,
  "errmsg": "updated"
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

name

string

可选

部门名称。长度限制为1~32个字符，字符不能包括:*?”<>｜

integer <int32>

部门id

必需

parentid

integer <int32>

父部门id

可选

name_en

string

可选

英文名称，需要在管理后台开启多语言支持才能生效。长度限制为1~32个字符，字符不能包括:*?”<>｜

order

integer <int32>

可选

在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

修改于 2022-12-01 02:54:34

创建部门

删除部门