ITHISTORY: Asset History
Audit trail event for an IT asset recording assignments, moves, status changes, maintenance, and other lifecycle events.
Default definition. This article describes the default
ITHISTORY 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 ITHISTORY.Entity properties
| Property | Value |
|---|---|
| Entity code | ITHISTORY |
| Display name | Asset History |
| Plural | Asset History |
| Level | 50500 |
Use cases
ITHISTORY is linked to ITASSET via comboKeyEntity and appears in the Documents & History panel. Each record represents a single significant event in an asset's lifecycle. The eventType categorises events: Assignment (user changes), Move (location changes), Status Change, Maintenance, Configuration Change, Warranty (claims/renewals), Audit, Disposal, and Other.
Fields
Event Record
| Field | Type | Required | Notes |
|---|---|---|---|
ref | text | Ref. | |
name | text | Yes | Event ID. |
asset | reference → ITASSET | Yes | IT Asset. |
date | datetime | Yes | Event Date. |
eventType | enum | Yes | Valid ids: 1 (Assignment), 2 (Move), 3 (Status Change), 4 (Maintenance), 5 (Configuration Change), 6 (Warranty), 7 (Audit), 8 (Disposal), 9 (Other). |
Event Details
| Field | Type | Required | Notes |
|---|---|---|---|
description | text (multi-line) | Yes | Description. |
previousValue | text | Previous Value. | |
newValue | text | New Value. |
Performed By
| Field | Type | Required | Notes |
|---|---|---|---|
performedBy | reference → user | Performed By. | |
source | enum | Valid ids: 1 (Manual), 2 (System), 3 (Import), 4 (Integration). | |
notes | text (multi-line) | Notes. |
Relationships
- Lookups:
assetpoints at aITASSETrecord;performedBypoints at a user.
Creating a Asset History via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "ITHISTORY",
"level": 50500,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"asset": "",
"date": 1776000000000,
"eventType": "1"
} Listing Asset History
# All records in your tenant
GET /v1/entities/ITHISTORY/SUB:<your-sub-id>