DTYPE: Document Type
A document type definition with default workflow participants, deadlines, and revision schedules.
DTYPE 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 DTYPE.Entity properties
| Property | Value |
|---|---|
| Entity code | DTYPE |
| Display name | Document Type |
| Plural | Document Types |
| Level | 12000 |
Use cases
DTYPE classifies documents and configures their default workflow behaviour. Each document type belongs to a category (DTYPECAT) for hierarchical organisation. The workflow configuration section defines default reviewer and approver roles (via objectMultiselect to ROLE), review and approval deadline days, and a revision period that triggers mandatory re-review after expiry. These defaults are applied when a new document of this type is created, but can be overridden per document. The ref field provides a system-generated type identifier. The active flag allows types to be retired without deletion. DTYPE works with DRECORD (documents reference their type), DASSIGNEE (assignees can be scoped to specific types), and the workflow engine to determine who should review/approve documents and by when.
Fields
Document Type Details
| Field | Type | Required | Notes |
|---|---|---|---|
ref | text | Type ID. Read only. | |
name | text | Yes | Name. |
description | text (multi-line) | Description. | |
category | reference → DTYPECAT | Category. | |
active | enum | Yes | Valid ids: 0 (No), 1 (Yes). |
Workflow Configuration
| Field | Type | Required | Notes |
|---|---|---|---|
defaultReviewers | objectMultiselect | Roles that will review documents of this type by default | |
defaultApprovers | objectMultiselect | Roles that approve documents of this type by default | |
reviewDeadlineDays | number | Yes | Review Deadline (days). |
approvalDeadlineDays | number | Yes | Approval Deadline (days). |
revisionPeriodDays | number | Yes | After this period, the document must be re-reviewed |
Internal Notes
| Field | Type | Required | Notes |
|---|---|---|---|
notes | text (multi-line) | Notes. |
Relationships
- Lookup:
category(reference →DTYPECAT).
Creating a Document Type via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "DTYPE",
"level": 12000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example name",
"active": "0",
"reviewDeadlineDays": 0,
"approvalDeadlineDays": 0
}
Listing Document Types records
GET /v1/entities/DTYPE/SUB:<your-sub-id>