Skip to Content

POST /department/delete

Delete Department

Bulk delete departments — composable infra architecture.

Request Body (DeleteDepartmentApiRequest)

FieldTypeRequiredDescription
department_idsstring[]NoUUIDs of departments to delete (required on first call when all is false)
allbooleanNoWhen true, delete every department matching the filter fields below (minus excluded_ids)
excluded_idsstring[]NoUUIDs to skip even when matched by all-mode filters
searchstringNoFull-text search query
flag_searchstringNoSearch text for flag facet (no-op for row filtering)
idempotency_keystringNoOperation key for ack — confirms or rejects a dormant delete
softbooleanNoStage the delete dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it
acceptbooleanNoAccept (confirm) or reject dormant state. Only meaningful with idempotency_key

Response (DeleteDepartmentApiResponse)

FieldTypeRequiredDescription
resultsDeleteDepartmentResult[]YesPer-item deletion results
idempotency_keystringNoIdempotency key echoed back for client correlation
Last updated on