Skip to main content
A division belongs to one tenant and can be a root division or a child of another division in the same tenant.

​
Endpoints

List divisions

Query the hierarchy by tenant, name, parent, order, cost center, and timestamps.

Create a division

Create a root or child division with dry-run validation.

Get a division

Read one division by ID.

Update a division

Rename, reorder, reparent, or change the cost center.

​
Validation rules

  • Parent and child must belong to the same tenant.
  • A parent change cannot create a hierarchy cycle.
  • A division name must be unique among siblings.
  • parentId: null represents a root division.
  • Nullable costCenter can be cleared with null.
  • The public v1 contract does not expose division deletion.

Division management guide

Use safe create, reparenting, ordering, and conflict-resolution patterns.
Last modified on August 27, 2026