POST `/admin/tenants/{tenant_id}/departments`

在指定租户下创建新部门，可指定父部门以构建层级组织架构

租户服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`tenant_id`	`path`	`string`	是				租户ID

请求体

Schema： service-tenant/internal/handler/dto.CreateDepartmentRequest

字段	类型	必填	示例	约束	描述
`name`	`string`	是	`技术研发部`		部门名称
`code`	`string`	否	`RD`		部门编码
`manager_id`	`string`	否	`usr_001`		负责人ID
`parent_id`	`string`	否	`dept-root`		父部门ID

响应

状态	描述	Schema
201	创建成功	`service-tenant/internal/handler/dto.DepartmentDetailResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
403	权限不足	`service-core/base/dto.SimpleResponse`
409	资源冲突	`service-core/base/dto.SimpleResponse`
500	服务器内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-tenant/internal/handler/dto.DepartmentDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-tenant/internal/handler/dto.DepartmentResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-tenant/internal/handler/dto.DepartmentResponse

租户部门信息

字段	类型	必填	示例	约束	描述
`code`	`string`	否	`RD`		部门编码
`created_at`	`string`	否	`2026-01-15T10:30:00Z`		创建时间
`department_id`	`string`	否	`dept_001`		部门ID
`manager_id`	`string`	否	`usr_001`		负责人ID
`members_count`	`integer`	否	`25`		成员数量
`name`	`string`	否	`技术研发部`		部门名称
`parent_id`	`string`	否	`dept_root`		父部门ID
`tenant_id`	`string`	否	`tnt_abc123`		租户ID

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓