Task

Add a task to a record. `title` and `relatedRecord.id` are required, and `relatedRecord.id` must resolve to a change order; `taskGroupId` must resolve to an active change order task group and `assignedToUserId` to a user. `sequence` omitted appends the task after the last step, and a value places it at that step, alongside any task already there. Creating the task already complete stamps `completedUtc` and `completedBy`.

post/api/tasks

Request body

titlestring required

What the task is. Required

descriptionstring nullable

A longer description of the task

notesstring nullable

Free-text notes on the task

dueDateUtcstring date-time nullable

When the task is due (UTC)

assignedToUserIdstring nullable

The user to assign the task to. Must resolve to a user

taskGroupIdstring nullable

The group to file the task under. Must resolve to an active change order task group

completeboolean

Whether the task is complete. Setting it true completes the task and stamps completedUtc and completedBy; setting it false re-opens the task and clears both

sequenceinteger nullable

The step the task should sit at. A value of 1 or more places it at that step, alongside any task already there. Null or a value below 1 appends it after the last step on a create and leaves it where it is on an update

Response

The created task

idstring nullable

The id of the task

titlestring nullable

What the task is

descriptionstring nullable

A longer description of the task

notesstring nullable

Free-text notes on the task

sequenceinteger

The step the task sits at within its record's task list. Tasks sharing a step are parallel work, so a step is not unique within a record

dueDateUtcstring date-time nullable

When the task is due (UTC), or null when it carries no date

completeboolean

Whether the task is complete

completedUtcstring date-time nullable

When the task was completed (UTC). Server-stamped when the task is first marked complete and cleared when it is re-opened. Read-only

attachmentCountinteger

How many attachments the task carries

Changes