添加部门
添加一个新部门。
请求 URL
POST {base_url}/{api_path}/organization/create?access_token={access_token}
请求参数
| 参数 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| name | 是 | String | 部门名称。 |
| parent_id | 是 | Integer | 父部门的唯一 ID。 注: 可使用 搜索特定部门 接口搜索部门
ID。 |
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | Integer | 返回错误码。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息。
|
| errmsg | String | 返回信息。
|
| 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 }