RESTTasks

Update task status

Update the status of a task.

Path parameters

taskIdstringRequired
ID of task to update status of

Request

This endpoint expects an object.
statusVersionintegerOptional
The status version of the task to update. This version number increments to indicate the task's current stage in its status lifecycle. Specifically, whenever a task's status updates, the status version increments by one. Any status updates received with a lower status version number than what is known are considered stale and ignored.
newStatusobjectOptional
The new status of the task.
authorobjectOptional
A Principal is an entity that has authority over this Task.

Response

Task status update was successful
versionobject or null
Version of this Task.
displayNamestring or null

DEPRECATED: Human readable display name for this Task, should be short (<100 chars).

specificationobject or null
Full Task parameterization.
createdByobject or null
Records who created this Task. This field will not change after the Task has been created.
lastUpdatedByobject or null
Records who updated this Task last.
lastUpdateTimestring or nullformat: "date-time"
Records the time of last update.
statusobject or null
The status of this Task.
scheduledTimestring or nullformat: "date-time"
If the Task has been scheduled to execute, what time it should execute at.
relationsobject or null

Any related Tasks associated with this, typically includes an assignee for this Task and/or a parent.

descriptionstring or null
Longer, free form human readable description of this Task
isExecutedElsewhereboolean or null
If set, execution of this Task is managed elsewhere, not by Task Manager. In other words, Task manager will not attempt to update the assigned agent with execution instructions.
createTimestring or nullformat: "date-time"
Time of Task creation.
replicationobject or null
If populated, designates this to be a replicated Task.
initialEntitieslist of objects or null

If populated, indicates an initial set of entities that can be used to execute an entity aware task For example, an entity Objective, an entity Keep In Zone, etc. These will not be updated during execution. If a taskable agent needs continuous updates on the entities from the COP, can call entity-manager, or use an AlternateId escape hatch.

ownerobject or null
The networked owner of this Task. It is used to ensure that linear writes occur on the node responsible for replication of task data to other nodes running Task Manager.

Errors