CreateDepartmentRequest

A request or response body; the type column links to the schemas it refers to.

CreateDepartmentRequest

FieldTypeRequiredDescription
slugstringyes

Unique within the organization. Slugs are lowercase letters and digits in words separated by single hyphens, like customer-success.

1–100 characters · matches ^[a-z0-9]+(-[a-z0-9]+)*$

namestringyes

1–200 characters

descriptionstringno

Omit or send empty for no description.

at most 2000 characters

parent_department_idstring (uuid)no

Nests the new department under one in the same organization.

jsonExample
{
  "slug": "quality-assurance",
  "name": "Quality Assurance",
  "description": "string",
  "parent_department_id": "1b671a64-40d5-491e-99b0-da01ff1f3341"
}