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.

taskStartConfigTaskStartConfigDto
recurrenceRecurrenceConfigDto
dueDateConfigDueDateConfigDto
statutoryDateConfigStatutoryDateConfigDto
taskDateBasisenum

Any StartDate DueDate StatutoryDate CompletedDate

Any StartDate DueDate StatutoryDate CompletedDate

startHolidayAdjustmentenum

None Skip MoveBefore MoveAfter

None Skip MoveBefore MoveAfter

dueHolidayAdjustmentenum

None Skip MoveBefore MoveAfter

None Skip MoveBefore MoveAfter

assignmentTypeenum

Unassigned SpecificUser ClientManager ClientServiceManager ClientPartner ClientAssociate

Unassigned SpecificUser ClientManager ClientServiceManager ClientPartner ClientAssociate

workflowCodeAndNameDto
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)

checklistarray of ChecklistItemDto

Checklist items for this recurring task template

Checklist items for this recurring task template

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