ITASSIGNMENT: IT Asset Assignment
Tracks the assignment history of IT assets to staff members, recording check-out and check-in events with dates, condition, and location.
Default definition. This article describes the default
ITASSIGNMENT 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 ITASSIGNMENT.Entity properties
| Property | Value |
|---|---|
| Entity code | ITASSIGNMENT |
| Display name | IT Asset Assignment |
| Plural | IT Asset Assignments |
| Level | 50200 |
Use cases
ITASSIGNMENT provides a complete audit trail of asset custody. Each assign action creates a new record; each return action closes it by setting returnDate and conditionOnReturn. Linked to ITASSET via comboKeyEntity.
Fields
Assignment
| Field | Type | Required | Notes |
|---|---|---|---|
ref | text | Ref. | |
assignedTo | reference → STF | Assigned To. | |
department | reference → DEPT | Department. | |
assignmentDate | date | Assigned Date. | |
returnDate | date | Returned Date. |
Location & Condition
| Field | Type | Required | Notes |
|---|---|---|---|
building | text | Building. | |
floor | text | Floor. | |
room | text | Room. | |
conditionOnReturn | enum | Valid ids: good (Good), fair (Fair), damaged (Damaged), defective (Defective). | |
notes | text (multi-line) | Notes. |
Relationships
- Lookups:
assignedTopoints at aSTFrecord;departmentpoints at aDEPTrecord.
Creating a IT Asset Assignment via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "ITASSIGNMENT",
"level": 50200,
"comboKey": "SUB:<your-sub-id>|ENT:",
"ref": "...",
"assignedTo": "",
"department": "",
"assignmentDate": "2026-01-15"
} Listing IT Asset Assignments
# All records in your tenant
GET /v1/entities/ITASSIGNMENT/SUB:<your-sub-id>