Skip to main content

Creating and managing Tasks

Task actions create ordinary work items that your team can find in the Task backlog. A created Task remains a business result even if the workflow later fails or is cancelled.

Read Taskโ€‹

Select an existing Task by its ID, entered directly or mapped from a preceding step. The step captures its title, status, assignment and location. Later steps use that captured result even if someone changes the Task afterwards. Publishing a Read Task step requires Task read permission.

Create Taskโ€‹

Configure a title using fixed text or supported mapped values. The resolved title must be nonblank and no longer than 255 characters. Optionally select an assignee and link the triggering record, including a link role where configured.

Choose Simple for work without a destination or Visit for work at a location. A Visit requires a complete location: coordinates, or a street and country. Map the whole location from a preceding Read record or Task step to preserve its address details and timestamp.

For a recurring workflow, turn off the triggering-record link: there is no implicit record. Assignment organizes work but does not grant permission to read or change the Task.

Use a Wait step to delay execution, or an explicit If/Else block to run the Task step conditionally. The step creates the Task when it executes; it does not wait for a person to complete it. Inspect the run to find the committed Task and its resolved inputs.

Update Taskโ€‹

Select a preceding Create Task or Read Task step from this run. It must be guaranteed to run on every path leading to the update. Read an existing Task first to update it.

Change the title, assignment, status, or a combination of them. Assignment has three intentions: keep the existing assignee, set a selected user, or clear assignment. Choose at least one update. Use an explicit If/Else block to choose whether the update runs, or a Wait step to postpone it.

Choose Done to complete the Task or Open to reopen it. Leaving Status unchanged preserves the current status. Setting the same status again is allowed. Other changes are applied before the status, and all changes are saved together. The preview shows the requested status; after execution, run details show the final Task.

For a Visit, you can also replace its whole location. Fields missing from the copied value clear old destination details. Leaving the location mapping empty preserves the existing location. An empty or unresolved mapped source fails before changing the Task.

For example: create a review Task, wait for a deadline, then update its title to identify the next stage. This is an automated update, not an automatic check that someone completed the earlier work.

Publishing Create or Update Task steps requires Task write permission. Native Task steps do not require workflow code execution permission. Completing a Task uses Update Task with Status set to Done; it does not wait for human acknowledgement.

Copy locations between Tasks and recordsโ€‹

Read the source record, map its location into Create or Update Task, then map the Task result's location into an Update record step. A tracked record location is resolved when read and copied as a fixed value. The Task does not follow later source changes. A non-Visit Task has no location; copying that empty value into a nullable record location clears the destination.

Results and failuresโ€‹

Read, create and update operations retain their committed results so delivery retries do not repeat the same operation or refresh a captured read. Run details show the captured Task output. A new manual run is different and can create another Task.

If a Task operation is rejected, inspect its step for the actual validation or access failure. Do not assume that a later failed step rolled back a Task created earlier.

Use Ask Question, including its Approval preset when continuation must depend on a human response. These questions create question Tasks with a dedicated answer lifecycle, rather than ordinary completion controls.

See also the Task API guide.