POST /department/create
Create Department
Create departments using composable infra architecture.
Request Body (CreateDepartmentApiRequest)
| Field | Type | Required | Description |
|---|---|---|---|
departments | CreateDepartmentItem[] | Yes | List of departments to create |
idempotency_key | string | No | Operation key for ack — promotes or rejects a dormant create |
soft | boolean | No | Stage the create dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it |
accept | boolean | No | Accept (promote) or reject dormant state. Only meaningful with idempotency_key |
Response (CreateDepartmentApiResponse)
| Field | Type | Required | Description |
|---|---|---|---|
results | DepartmentResultItem[] | Yes | Per-item creation results |
idempotency_key | string | No | Idempotency key echoed back for client correlation |
departments | ListDepartmentApiDepartment[] | No | Hydrated rows for the successfully-created departments (mirrors /department/search shape) |
Last updated on