Playground

Playground

OffboardingTask

/api/v1/hr/offboarding-tasks

A task in a leaver's offboarding sequence.

listgetcreateupdatecomplete

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
person_iduuidUUID of the Person (departing employee) this offboarding task belongs to.
titlestringShort, action-oriented title for the task.
descriptionstringDetailed instructions or context for completing this task.
categorystringFunctional category grouping tasks of a similar nature together in the offboarding checklist.
assigned_to_iduuidUUID of the Person responsible for completing or facilitating this task. Typically IT, HR, or the departing employee's manager.
due_datedate-timeISO 8601 date by which this task must be completed.
completed_atdate-timeISO 8601 timestamp when this task was marked completed. Null while still pending or in progress.
statusstringCurrent execution state of this task.
ordernumberZero-based display order within the offboarding checklist. Lower values appear first.
template_iduuidUUID of the offboarding template from which this task was generated. Null for ad-hoc tasks created directly.

API

client.hr.offboardingTasks.*
Loading manifest…