DemandFlow Support Centre

DAPPROVAL: Document Approval

ReferenceEntity Reference16/04/2026Updated 16/04/2026
A document approval record tracking an approver's decision (pending, approved, or rejected) on a version.

DAPPROVAL: Document Approval

A document approval record tracking an approver's decision (pending, approved, or rejected) on a version.

Default definition. This article describes the default DAPPROVAL 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 DAPPROVAL.

Entity properties

PropertyValue
Entity codeDAPPROVAL
Display nameDocument Approval
PluralDocument Approvals
Level12040

Use cases

DAPPROVAL records individual approval decisions on document versions. It uses view:simple (flat field list rather than panelled layout) because it is a lightweight workflow record typically managed through the parent version's approval panel (dversionapprovals) rather than opened independently. The name field is a singleuser lookup identifying the approver (readonly, set by the system). Status tracks the decision (Pending > Approved/Rejected) with decisionBy and decisionDate recording who acted and when. The approverComment field captures the approver's feedback. All audit fields (ownerId/created for request, decisionBy/decisionDate for response) are readonly to maintain integrity. Multiple DAPPROVAL records per version support multi-party approval workflows where several approvers must sign off.

Fields

No form fields in the default definition.

Relationships

  • No declared relationships in the default definition.

Creating a Document Approval via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "DAPPROVAL",
  "level":    12040,
  "comboKey": "SUB:<your-sub-id>|ENT:"
}

Listing Document Approvals records

GET /v1/entities/DAPPROVAL/SUB:<your-sub-id>

See also

dapprovaldocumentapprovalapprovalsdocumentapprovalsrecordtrackingapproverdecisionpendingapproved

Was this article helpful?

← Back to Knowledge Base