SVCAPPROVAL: Service Approval
An approval record representing a single approver's decision on a service request. Multiple approval records can exist per request to support parallel approvers. Driven by the SVCCAT approvalRequired flag.
Default definition. This article describes the default
SVCAPPROVAL 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 SVCAPPROVAL.Entity properties
| Property | Value |
|---|---|
| Entity code | SVCAPPROVAL |
| Display name | Service Approval |
| Plural | Service Approvals |
| Level | 50675 |
Use cases
An approval record representing a single approver's decision on a service request. Multiple approval records can exist per request to support parallel approvers. Driven by the SVCCAT approvalRequired flag.
Fields
Approval
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Subject. Read only. |
status | enum | Yes | Valid ids: 1 (Pending), 2 (Approved), 3 (Rejected), 4 (Cancelled). |
approver | reference → user | Yes | Approver. |
comment | text (multi-line) | Decision comment. | |
decidedDate | datetime | Decided at. Read only. |
Request
| Field | Type | Required | Notes |
|---|---|---|---|
requestId | reference → SVCREQ | Service Request. Read only. | |
requestName | text | Request subject. Read only. | |
requestedBy | reference → user | Requested by. Read only. | |
serviceCatalogItem | reference → SVCCAT | Catalogue item. Read only. |
Attachments and additional panels
- Activity timeline panel attached.
Relationships
- Lookups:
requestIdpoints at aSVCREQrecord;serviceCatalogItempoints at aSVCCATrecord.
Creating a Service Approval via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "SVCAPPROVAL",
"level": 50675,
"comboKey": "SUB:<your-sub-id>|ENT:",
"status": 1,
"approver": ""
}
Listing Service Approvals
GET /v1/entities/SVCAPPROVAL/SUB