Changes a task. Setting “To do” on a task assigned to a Digital Worker starts the worker.
- Changes data: yes
- Who can use it: Any member of the brand.
What it is for
- Move a task, start a worker with “To do”, block it with a reason. See Tasks and Digital Workers.
Example prompts
- “Mark the task “Demo: Call the consignee” as done.”
- “Block the task “Demo: Call the consignee”: waiting for the consignee’s answer.”
Reference
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
task_id | string | yes | The task. |
title | string | no | New title. |
description | string | no | New description. |
status | string | no | backlog, todo, in_progress, blocked, done or cancelled. |
priority | string | no | low, medium, high or urgent. |
deadline | string | no | Date and time, ISO 8601. Give the time in UTC. A date without a time means 00:00 UTC. |
parent_id | string | no | New parent task. |
comment | string | no | A comment. Required when the status becomes blocked. |
Returns
The updated task.
Errors
- “A comment explaining the blocker is required.”
- “A task cannot be its own parent.”, “Parent task not found.”, “This parent would create a cycle.”
- “Task not found.”
- A Digital Worker that is not active.