ISSUE: Issue
An issue register entry tracking active problems with category, impact assessment, and contingency planning.
Default definition. This article describes the default
ISSUE 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 ISSUE.Entity properties
| Property | Value |
|---|---|
| Entity code | ISSUE |
| Display name | Issue |
| Plural | Issues |
| Level | 55000 |
Use cases
ISSUE is the project issue register entity, structurally similar to RISK but for problems that have already materialised rather than potential future events. It is linked to projects via comboKey SUB|PJ. Unlike RISK, it omits the probability field (issues have already occurred) and focuses on impact assessment and resolution.
Fields
Issue
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Issue. |
description | text | Description. |
Impact
| Field | Type | Required | Notes |
|---|---|---|---|
category | enum | Yes | Valid ids: technical (Technical), financial (Financial), operational (Operational), resource (Resource), legal (Legal), environmental (Environmental). |
impact | enum | Yes | Valid ids: low (Low), medium (Medium), high (High). |
Manage
| Field | Type | Required | Notes |
|---|---|---|---|
contingency_plan | text | Yes | Contingency Plan. |
status | enum | Yes | Valid ids: open (Open), closed (Closed), monitoring (Monitoring), resolved (Resolved). |
contingency_plan | text (multi-line) | Contingency Plan. | |
next_review_date | date | Next Review Date. |
Relationships
- No declared relationships in the default definition.
Creating a Issue via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "ISSUE",
"level": 55000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"category": "technical",
"impact": "low",
"contingency_plan": "..."
}Listing Issues
# All records in your tenant
GET /v1/entities/ISSUE/SUB:<your-sub-id>