ITSTATUS: IT Status
IT asset lifecycle status with configurable rules for assignment, checkout, depreciation, and alerting.
Default definition. This article describes the default
ITSTATUS 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 ITSTATUS.Entity properties
| Property | Value |
|---|---|
| Entity code | ITSTATUS |
| Display name | IT Status |
| Plural | IT Statuses |
| Level | 55000 |
Use cases
ITSTATUS goes beyond a simple name/description lookup - it is a rule-driven status entity that controls IT asset behaviour based on the current lifecycle state. The category field groups statuses into Active, Inactive, Maintenance, Transition, and End of Life, providing a high-level state machine. The Status Rules section is the key design element: allowAssignment and allowCheckout control whether assets in this status can be assigned to users or checked out, preventing allocation of decommissioned or broken equipment.
Fields
Status Information
| Field | Type | Required | Notes |
|---|---|---|---|
ref | text | Ref. | |
name | text | Yes | Status Code Name. |
description | text | Yes | Status Description. |
category | enum | Yes | Valid ids: 1 (Active), 2 (Inactive), 3 (Maintenance), 4 (Transition), 5 (End of Life). |
color | text | Display Color. | |
sortOrder | number | Sort Order. | |
active | enum | Yes | Valid ids: 1 (Yes), 0 (No). |
defaultStatus | enum | Valid ids: 1 (Yes), 0 (No). |
Status Rules
| Field | Type | Required | Notes |
|---|---|---|---|
allowAssignment | enum | Valid ids: 1 (Yes), 0 (No). | |
allowCheckout | enum | Valid ids: 1 (Yes), 0 (No). | |
depreciationEnabled | enum | Valid ids: 1 (Yes), 0 (No). | |
maintenanceRequired | enum | Valid ids: 1 (Yes), 0 (No). | |
inventoryTracked | enum | Valid ids: 1 (Yes), 0 (No). | |
alertsEnabled | enum | Valid ids: 1 (Yes), 0 (No). | |
reportingCategory | text | Reporting Category. | |
notes | text (multi-line) | Notes. |
Relationships
- No declared relationships in the default definition.
Creating a IT Status via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "ITSTATUS",
"level": 55000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"description": "...",
"category": "1",
"active": "1"
}Listing IT Statuses
# All records in your tenant
GET /v1/entities/ITSTATUS/SUB:<your-sub-id>