更新时间：2025-11-03 GMT+08:00
创建组织 - CreateOrganization
功能介绍
创建组织。
接口约束
null
URI
POST /api/v2/tenant/organizations
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 该字段内容填为“application/json;charset=utf8”。 |
Authorization | 是 | String | 认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
code | 是 | String | 组织编码，可输入中英文、数字、下划线和中划线。 |
name | 是 | String | 组织名称，所在层级下唯一，可输入中英文、数字、空格、中划线、下划线和&。 |
parent_id | 否 | String | 父组织id。创建父组织，不需要传递；创建子组织，需要传递。 |
category | 否 | String | 组织类型。 |
响应参数
状态码：201
参数 | 参数类型 | 描述 |
|---|---|---|
org_id | String | 组织ID。 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误编号。 |
error_msg | String | 错误详情。 |
请求示例
创建组织，组织名子部门，组织编码1000001，父组织编码20210623103509267-6ABA-201FFC...，组织类型部门。
POST https://{domain_name}/api/v2/tenant/organizations
Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...
{
"code": "1000001",
"name": "子部门",
"parent_id": "20210623103509267-6ABA-201FFC...",
"category": "department"
} 响应示例
状态码：201
创建成功。
{
"org_id" : "20210623103509267-6ABA-201FFC..."
} 状态码
状态码 | 描述 |
|---|---|
201 | 创建成功。 |
400 | 参数无效。 |
错误码
请参见错误码。
父主题：组织管理
