创建一个部门。 ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：CreateDepartment` 要执行的操作，取值：CreateDepartment。 **Version** string 必选 `示例值：2026-05-01` API的版本，取值：2026\-05\-01。 **SpaceId** string 必选 `示例值：csi-yei8347ta8xmf5qd****` 部门所属空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。 **Name** string 必选 `示例值：Frontend` 部门名称，长度不超过 255 字符。

说明

同一上级部门内的部门名称需唯一。

**ParentDepartmentId** string 必选 `示例值：root` 上级部门 ID。 * 创建一级部门：传`root`表示根部门。 * 创建子部门：上级部门 ID 可以在ArkClaw控制台“用户管理 \> 部门管理”页面获取。 **Description** string `可选` `示例值：负责平台前端研发` 部门描述。 * 长度不超过 2048 字符。 * 不填默认为空。 **ExternalId** string 必选 `示例值：ext-123456` 外部系统中的部门唯一标识 ID，长度不超过 512 个字符。

说明

在同一 ArkClaw 企业版空间内，同一数据来源下的 ExternalId 不能重复。

## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **Department** object `示例值：--` 创建成功的部门信息。 **CreateTime** string `示例值：2026-05-27T12:00:00Z` 部门的创建时间，时间格式为RFC3339 UTC。 **DepartmentId** string `示例值：2479e108-1a5c-4311-****` 部门ID。 **Description** string `示例值：负责平台前端研发` 部门描述。 **DirectChildrenCount** integer `示例值：3` 直属子部门数量。 **DirectMemberCount** integer `示例值：10` 部门直属成员数（仅统计当前部门，不包含子部门）。 **ExternalId** string `示例值：ext-123456` 外部系统中的部门唯一标识 ID。 **MemberCount** integer `示例值：30` 部门成员总数（统计当前部门及其所有子部门的成员）。 **Name** string `示例值：Frontend` 部门名称。 **NamePath** string `示例值：/Engineering/Frontend` 部门名称路径，表示该部门在部门树中的层级位置（由各级部门名称拼接）。 **ParentDepartmentId** string `示例值：root` 上级部门 ID，返回 "root" 表示根部门。 **Path** string `示例值：/root/fdeeba37-51e7-****/2479e108-1a5c-4311-****` 部门 ID 路径，表示该部门在部门树中的层级位置（由各级部门 ID 拼接，包含 `root`）。 **SpaceId** string `示例值：csi-yei8347ta8xmf5qd****` 部门所属空间ID。 **UpdateTime** string `示例值：2026-05-27T12:10:00Z` 部门的更新时间，时间格式为RFC3339 UTC。 ## 请求示例 ```json POST /?Action=CreateDepartment&Version=2026-05-01 HTTP/1.1 Host: https://arkclaw.cn-beijing.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20260828T092603Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260828/cn-beijing/arkclaw/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "SpaceId": "csi-yei8347ta8xmf5qd****", "Name": "Frontend", "ParentDepartmentId": "root", "ExternalId": "ext-123456" } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "202608281743462302452****", "Action": "CreateDepartment", "Version": "2026-05-01", "Service": "arkclaw", "Region": "cn-beijing" }, "Result": { "Department": { "CreateTime": "2026-05-27T12:00:00Z", "DepartmentId": "2479e108-1a5c-4311-****", "Description": "负责平台前端研发", "DirectChildrenCount": 3, "DirectMemberCount": 10, "ExternalId": "ext-123456", "MemberCount": 30, "Name": "Frontend", "NamePath": "/Engineering/Frontend", "ParentDepartmentId": "root", "Path": "/root/fdeeba37-51e7-****/2479e108-1a5c-4311-****", "SpaceId": "csi-yei8347ta8xmf5qd****", "UpdateTime": "2026-05-27T12:10:00Z" } } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |MissingParameter.SpaceId |The required parameter SpaceId is not supplied. |参数SpaceId不能为空。 | |400 |MissingParameter.ExternalId |The required parameter ExternalId is not supplied. |参数ExternalId不能为空。 | |400 |MissingParameter.Name |The required parameter Name is not supplied. |名称不能为空。 | |400 |MissingParameter.ParentDepartmentId |The required parameter ParentDepartmentId is not supplied. |参数ParentDepartmentId不能为空。 | |404 |InvalidSpace.NotFound |The specified space does not exist. |指定的ClawSpace不存在。 | |404 |InvalidResource.NotFound |The specified resource does not exist. |指定资源不存在。 | |500 |ErrGetClawSpaceFailed |get claw space failed. |space获取失败。 | |500 |InternalError |An internal error has occurred. |内部错误，请重试。如果多次尝试失败，请提交工单。 |