添加部门

添加一个新部门。

请求 URL

POST {base_url}/{api_path}/organization/create?access_token={access_token}

请求参数

1.
参数 是否必填 类型 说明
name String 部门名称。
parent_id Integer 父部门的唯一 ID。
注: 可使用 搜索特定部门 接口搜索部门 ID。

响应参数

2.
参数 类型 说明
errcode Integer 返回错误码。
  • 0:请求成功。
  • 非零值:请求失败。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息
errmsg String 返回信息。
  • SUCCESS:请求成功。
  • FAILURE:请求失败。
id Integer 部门的唯一 ID。

示例

请求示例

在根部门下创建一个名为 UA group 的子部门。

POST /openapi/v1.0/organization/create?access_token=hlVf2mmJD9A94tLv6PYVmEU3bO8wUgZx 

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json

{
    "name": "UA group",
    "parent_id": 1
}

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "id": 5
}