DEPTSTF: Department Staff
A staff member assignment within a department, linking a user to a position in the org hierarchy.
DEPTSTF definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches DEPTSTF.Entity properties
| Property | Value |
|---|---|
| Entity code | DEPTSTF |
| Display name | Department Staff |
| Plural | Department Staff |
| Level | 2000 |
Use cases
DEPTSTF is the leaf of the organisational hierarchy (ENT > BU > DIV > DEPT > DEPTSTF), representing a person's membership in a department. It is linked to its parent department via comboKey SUB|DEPT. The entity is intentionally minimal with just two fields: name (singleuser lookup identifying the person) and position (their role within the department). This lightweight design reflects that DEPTSTF is a junction entity connecting system users to the organisational structure. It is distinct from STF (which represents staff/contractors with employment details and day rates) because DEPTSTF focuses on organisational placement rather than employment terms. A person can appear in multiple departments by having multiple DEPTSTF records, supporting matrix organisation structures.
Fields
Person
| Field | Type | Required | Notes |
|---|---|---|---|
name | reference → user | Yes | Name. |
position | text | Position. |
Relationships
- No declared relationships in the default definition.
Creating a Department Staff via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "DEPTSTF",
"level": 2000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "",
"position": "Example value"
} Listing Department Staff records
GET /v1/entities/DEPTSTF/SUB:<your-sub-id>