Employees
People you equip — read, create, update, and delete employees.
List employees
Returns a page of employees. Filter with the optional query params; all filtering rides server-side key conditions. Sensitive fields are never returned.
Create an employee
Creates an employee. Every foreign key you set (costCenterId / costCenter2Id / jobRoleId / sectorId / groupId) must exist in your organization, or the write is rejected with `422`. On success the `ETag` header carries the new record's version and `Location` points at the new resource.
Get an employee by id
Get an employee by id
Update an employee
Partial update — only the fields you send change; omitted fields are left intact (no blanking). Send the current version via the `If-Match` header (preferred; from the `ETag` of a prior read) or the body `_version`. Missing → `400`; stale → `409`. Any foreign key you set must exist in your organization, or the write is rejected with `422`.
Delete an employee
Soft-deletes the employee and returns the deleted record. Send the current version via the `If-Match` header (preferred; from the `ETag` of a prior read) or the `_version` query param. Missing → `400`; stale → `409`.