API Docs / Schemas / WorkflowDto

WorkflowDto

DTO for workflow templates, exposing only codes and structured data (never DB IDs).

Properties

Name Type Description
codestring

Stable identifier. For library-shipped items this is the library code; for tenant-imported
items this is the tenant entity's own code.

Stable identifier. For library-shipped items this is the library code; for tenant-imported
items this is the tenant entity's own code.

namestring

Display name shown to users in lists, dialogs, and the import browser.

Display name shown to users in lists, dialogs, and the import browser.

descriptionstring

Optional human-readable summary of what this entity is for.

Optional human-readable summary of what this entity is for.

libraryCodestring

The Code of the library template this entity was imported from, or null if the entity
is not from the library. Read-only — cannot be changed once set. Example: "vat_returns".

The Code of the library template this entity was imported from, or null if the entity
is not from the library. Read-only — cannot be changed once set. Example: "vat_returns".

libraryStatusenum

Describes a library-imported entity's relationship to its source library template.

NotFromLibrary UpToDate LocallyModified LibraryUpdated

Describes a library-imported entity's relationship to its source library template.

NotFromLibrary UpToDate LocallyModified LibraryUpdated

isImportedboolean

True if the tenant has already imported this library item.

True if the tenant has already imported this library item.

deprecatedboolean

True if this library item has been retired. Deprecated items are hidden from the import
browser (so new tasks cannot be created from them) but remain available for revert-to-library
on existing imports.

True if this library item has been retired. Deprecated items are hidden from the import
browser (so new tasks cannot be created from them) but remain available for revert-to-library
on existing imports.

deadlineRelativeToenum

DueDate StartDate

DueDate StartDate

groupCountinteger

Total number of groups in this workflow

Total number of groups in this workflow

stepCountinteger

Total number of steps across all groups in this workflow

Total number of steps across all groups in this workflow

groupsarray of WorkflowGroupDto

The workflow groups containing steps

The workflow groups containing steps

hasAutoExecutingStepsWithNoDependenciesboolean

Whether this workflow contains any auto-executing steps with no dependencies.
These steps will execute automatically when the workflow is applied to a task.

Whether this workflow contains any auto-executing steps with no dependencies.
These steps will execute automatically when the workflow is applied to a task.

requiresClientboolean

Whether this workflow requires a client to be associated with the task.
True if any email step uses client tokens in content or sends to client contact recipients.

Whether this workflow requires a client to be associated with the task.
True if any email step uses client tokens in content or sends to client contact recipients.

JSON Example

{
  "code": "string",
  "name": "string",
  "description": "string",
  "libraryCode": "string",
  "libraryStatus": "NotFromLibrary"
}

Used By Operations

Contained in Schemas