更新时间:2023-08-23 GMT+08:00
分享

修改组织

功能介绍

修改指定组织。

URI

PUT /api/v2/tenant/organizations/{org_id}

表1 路径参数

参数

是否必选

参数类型

描述

org_id

String

组织id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

该字段内容填为“application/json;charset=utf8”。

Authorization

String

认证凭据,值:Bearer {access_token},access_token通过“获取访问凭据”接口获取。

表3 请求Body参数

参数

是否必选

参数类型

描述

code

String

组织编码,组织编码为空时默认不修改,可输入中英文、数字、下划线和中划线。

最大长度:64

name

String

组织名称,组织名称为空时默认不修改,可输入中英文、数字、空格、中划线、下划线和&。

最大长度:100

parent_id

String

父组织id。

category

String

组织类型。

缺省值:department:部门

枚举值:

  • department:部门

  • company:公司

  • unit:科

  • group:组

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

org_id

String

组织ID。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

修改组织信息,组织编码为TestOrg,组织名为测试机构,父组织为根组织,组织类型为部门。

PUT https://{domain_name}/api/v2/tenant/organizations/{org_id}

Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...

{
    "code": "TestOrg",
    "name": "测试机构",
    "parent_id": "",
    "category": "department"
}

响应示例

状态码: 200

请求成功。

{
  "org_id" : "20210623103509267-6ABA-201FFC..."
}

状态码

状态码

描述

200

请求成功。

400

参数无效。

错误码

请参见错误码

分享:

    相关文档

    相关产品