docs-web-logo
开发文档

更新部门

调用该接口更新部门信息。

请求

基本
请求方式PATCH
请求地址/openapi/v3/contacts/departments/:department_id

请求头

名称类型必填描述
Authorizationstring是值格式：Bearer {{access_token}}

调用 API 时，需要通过访问凭证（access_token）进行身份鉴权，不同类型的访问凭证可获取的数据范围不同，参考 获取访问凭证 。

支持鉴权类型：
• 应用级token：以应用身份调用 API，校验应用的数据访问范围。参考 获取企业内部应用access_token。
• 用户级token：以登录用户身份调用 API，校验用户的可见数据范围。参考 获取登录用户access_token。
Content-Typestring是固定值：application/json; charset=utf-8

路径参数

名称类型必填描述
department_idstring是部门ID

请求参数

名称类型必填描述
department_namestring否部门名称
parent_idstring否父部门ID
managersarray否部门负责人ID数组
orderstring否部门排序

请求体示例

  1{
  2  "department_name": "",
  3  "parent_id": "",
  4  "managers": ["union_id1", "union_id2"],
  5  "order": "11"
  6}

响应

响应体

  1{
  2  "code": 0,
  3  "data": {},
  4  "msg": "ok",
  5  "trace_id": "ae4bd3d6d939f7790fa354e2402450e0"
  6}