Skip to main content

A department represents a subdivision of the employee workforce, most often erected around the type of activity they do.

Departments are a tree-like structure, as any department may be child to another.

Note: contrary to most resources, departments are not attached to business-establishments. This means:

  • business-establishments listed in access rights management do not affect departments.
  • employees may work in different business-establishments (or even legal-entities) and yet still belong to the same department.
​
name
string
required
Required string length: 1 - 255
​
remoteId
null | string

Identifier of this object in a third-party software.

Maximum string length: 255
​
isArchived
boolean

If this department is archived. Only possible if there are no more employees attached.

​
description
null | string
​
parent
department-reference · object

Reference to the department this department is a child of.

​
manager
employee-reference · object

Reference to the employee that acts as the Head of this department.

​
sortOrder
integer<int32>

Index (0-based) of the department among its siblings.

Required range: x >= 0