API Docs / Schemas / RecurringTaskItemDto

RecurringTaskItemDto

DTO for recurring task templates, exposing only codes and enums.

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.

timeEstimateMinutesinteger

The estimated time to complete each generated task, in whole minutes.

The estimated time to complete each generated task, in whole minutes.

assignedUserCodeAndNameDto
assignedTeamCodeAndNameDto
billableServiceCodeAndNameDto
sortOrderinteger

Sort order for displaying recurring tasks.

Sort order for displaying recurring tasks.

activeboolean

Whether this recurring task is active and will generate new tasks.

Whether this recurring task is active and will generate new tasks.

hasCustomSchedulesboolean

Whether any non-default schedules exist for this task. Maintained automatically as
schedules are created and deleted - not user-settable.

Whether any non-default schedules exist for this task. Maintained automatically as
schedules are created and deleted - not user-settable.

isDefaultScheduleboolean

Whether Schedule is the task's default. Only false when the list is filtered by client and
that client is linked to a custom schedule - Schedule then carries the custom values.

Whether Schedule is the task's default. Only false when the list is filtered by client and
that client is linked to a custom schedule - Schedule then carries the custom values.

customScheduleCodeAndNameDto
scheduleScheduleConfigDto
processProcessConfigDto
assignmentTypeenum

Unassigned SpecificUser ClientManager ClientServiceManager ClientPartner ClientAssociate

Unassigned SpecificUser ClientManager ClientServiceManager ClientPartner ClientAssociate

categoryCodeAndNameDto
clientAssociationTypeenum

None SpecificClients AllClients ClientsWithServices ClientsWithPipelines

None SpecificClients AllClients ClientsWithServices ClientsWithPipelines

vatReportingPeriodenum

Monthly QuarterlyJanAprJulOct QuarterlyFebMayAugNov QuarterlyMarJunSepDec Annual

Monthly QuarterlyJanAprJulOct QuarterlyFebMayAugNov QuarterlyMarJunSepDec Annual

nextRunDatestring

The next date this recurring task should be created (for display purposes)

The next date this recurring task should be created (for display purposes)

taskNameTemplatestring

Optional template for naming tasks created from this recurring task.
Supports {{ token }} placeholders (e.g. "VAT Return - {{ ClientName }} - {{ Quarter }} {{ Year }}").
When null or empty, tasks use the recurring task's Name.
Available tokens can be retrieved from the GET /metadata/task-name-tokens endpoint.
Unrecognised tokens are left as-is in generated task names.

Optional template for naming tasks created from this recurring task.
Supports {{ token }} placeholders (e.g. "VAT Return - {{ ClientName }} - {{ Quarter }} {{ Year }}").
When null or empty, tasks use the recurring task's Name.
Available tokens can be retrieved from the GET /metadata/task-name-tokens endpoint.
Unrecognised tokens are left as-is in generated task names.

JSON Example

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

Used By Operations

Contained in Schemas