CreateSysDept - 创建企业部门

通过 OpenAPI 创建企业部门(系统会默认创建两个部门:企业部门和其他部门。您可调用通过接口创建这两个部门的子部门。不再支持创建一级部门)。

适用版本

企业专属版

服务接入点

获取服务接入点,替换 API 请求语法中的 {domain}

授权信息

产品

资源

所需权限

组织管理

企业部门

读写

请求语法

POST  https://{domain}/oapi/v1/platform/departments

请求说明

创建企业部门

curl -X 'POST' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/platform/departments' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "name": "示例名",
        "parentId": "ebeb5a64-c98c-478a-9d9d-513841da****"
    }'

请求头(Headers)

x-yunxiao-token string (必选)

个人访问令牌。您可参考个人访问令牌获取。

示例:pt-0fh3****0fbG_35af****0484。

请求参数

name string (必选)

部门名称。

parentId string (必选)

父部门 ID。您可通过调用ListSysDepts 接口获取。

系统会默认创建两个一级部门:企业部门和其他部门,只支持创建一级部门的子孙部门,不支持创建一级部门。

返回参数

返回示例

{
    "id": "c113337e-a1e2-473d-9682-99da771c****",
    "name": "示例名",
    "creatorId": "bf2fce4f-7048-4017-a734-1c346e68****",
    "parentId": "ebeb5a64-c98c-478a-9d9d-513841da****"
}

id string

部门 ID。

name string

部门名称。

creatorId string

创建人 ID。

parentId string

父部门 ID。

错误码

访问错误码中心查看 API 相关错误码。