API Docs / Schemas / TaskItemDto

TaskItemDto

A task, either standalone or a workflow step (with parent task context)

Properties

Name Type Description
codestring

Unique identifier within the tenant

Unique identifier within the tenant

namestring

The name of the task

The name of the task

descriptionstring

The description of the task

The description of the task

statusenum

NotStarted InProgress Blocked Completed Skipped

NotStarted InProgress Blocked Completed Skipped

isProjectedboolean

Whether this task is projected (computed on the fly, not yet saved) or materialised (a saved task)

Whether this task is projected (computed on the fly, not yet saved) or materialised (a saved task)

timeEstimateMinutesinteger

The estimated time to complete the task, in whole minutes.

The estimated time to complete the task, in whole minutes.

startDatestring

When the task starts

When the task starts

dueDatestring

When the task is due

When the task is due

startTimestring

Time of day on SodiumHQ.DTOs.TaskItems.TaskItemDto.StartDate, in the practice's local time.

Time of day on SodiumHQ.DTOs.TaskItems.TaskItemDto.StartDate, in the practice's local time.

dueTimestring

Time of day on SodiumHQ.DTOs.TaskItems.TaskItemDto.DueDate, in the practice's local time.

Time of day on SodiumHQ.DTOs.TaskItems.TaskItemDto.DueDate, in the practice's local time.

isOverdueboolean

Indicates if the task is overdue (DueDate is before today and status is not Completed or Skipped)

Indicates if the task is overdue (DueDate is before today and status is not Completed or Skipped)

statutoryDueDatestring

The statutory due date for compliance tasks (if applicable)

The statutory due date for compliance tasks (if applicable)

originalStartDatestring

The start date this task was originally projected for, set once at materialisation and
never changed afterwards. Null for tasks that did not come from a recurring task.
Identifies an occurrence across both materialisation and later rescheduling.

The start date this task was originally projected for, set once at materialisation and
never changed afterwards. Null for tasks that did not come from a recurring task.
Identifies an occurrence across both materialisation and later rescheduling.

clientsarray of CodeAndNameDto

The clients this task is associated with

The clients this task is associated with

primaryClientCodeAndNameDto
clientManagerCodeAndNameDto
clientPartnerCodeAndNameDto
clientAssociateCodeAndNameDto
assignedUserCodeAndNameDto
assignedTeamCodeAndNameDto
createdDatestring

When the task was created

When the task was created

updatedDatestring

When the task was last updated

When the task was last updated

clientBillableServiceCodeAndNameDto
stageClientBillableServiceStageDto
clientPipelineCodeAndNameDto
recurringTaskCodeAndNameDto
workflowCodeAndNameDto
categoryCodeAndNameDto
workflowStepsinteger

The total number of workflow steps for this task

The total number of workflow steps for this task

workflowStepsCompleteinteger

The number of workflow steps completed for this task

The number of workflow steps completed for this task

isAutomationDisabledboolean

True when automation is switched off: the system never starts a workflow step on this
task. Staff can still run, complete, skip and reassign steps by hand.

True when automation is switched off: the system never starts a workflow step on this
task. Staff can still run, complete, skip and reassign steps by hand.

automationDisabledDatestring

When automation was switched off. Null while automation is on.

When automation was switched off. Null while automation is on.

automationDisabledByUserNamestring

Who switched automation off. Null means Sodium switched it off automatically.

Who switched automation off. Null means Sodium switched it off automatically.

workflowStepEstimateMinutesinteger

Summed estimated minutes of the task's non-omitted workflow steps. Null when the
task has no workflow or none of its steps carry an estimate. When present this is
the task's effective time estimate, overriding TimeEstimateMinutes.

Summed estimated minutes of the task's non-omitted workflow steps. Null when the
task has no workflow or none of its steps carry an estimate. When present this is
the task's effective time estimate, overriding TimeEstimateMinutes.

checklistarray of ChecklistItemDto

Checklist items for this task

Checklist items for this task

latestNoteContentstring

The most recent note/comment on this task

The most recent note/comment on this task

latestNoteDatestring

When the most recent note was created

When the most recent note was created

workflowStepDetailsWorkflowStepDetailsDto
nextStepsarray of NextStepDto

The task's currently-executable workflow steps (dependencies met, not complete, not
omitted), in group/step order. Includes auto-execute steps (flagged). Always empty for
Completed/Skipped tasks. Populated on list endpoints for main task rows; null on
workflow-step rows, projected tasks, and single-task responses.

The task's currently-executable workflow steps (dependencies met, not complete, not
omitted), in group/step order. Includes auto-execute steps (flagged). Always empty for
Completed/Skipped tasks. Populated on list endpoints for main task rows; null on
workflow-step rows, projected tasks, and single-task responses.

JSON Example

{
  "code": "string",
  "name": "string",
  "description": "string",
  "status": "NotStarted",
  "isProjected": false
}

Used By Operations

Contained in Schemas