Checkpoint Step
A Checkpoint step stops the run and hands it to a person. It creates a task, notifies the people you named, and parks the run until somebody continues it — by answering a form on the task, or from the Monitoring page. Whatever that person sends back becomes the step’s result. The step is called Checkpoint when you add it to a flow; its node type ishuman-in-the-loop.
Configuration
The editor has a General tab (name, ID and description), a Notifications tab with five fields, and a Form tab for answering on the task.A comma-separated list of user IDs. The editor is a user picker, so you choose people rather than typing IDs. Leave it empty and the step falls back to the account’s configured escalation responders.
Form tab
Add form fields to let the assignee answer on the task itself instead of from Monitoring.Form fields — the questions, built with the schema builder. Leave it empty for the Continue-only behaviour described below.
Use an existing task — a task ID, or a path to one such as
$.CREATE_TASK.id. Leave it empty to create a new task.What happens when the run reaches it
1
A task is created
A task is opened in the ESCALATE space with your title, description and priority, assigned to the people you named. It carries the run ID and the flow’s subject in its metadata.
2
Assignees are notified
Each assignee is emailed. The email links to the task and to the run itself, at
/en/hub/monitoring?run-id=…&highlight-continue=true — which opens Monitoring with the Continue control highlighted.3
The run parks
The run’s status becomes paused, and its remaining graph and collected data are stored so it can be picked up later. Nothing downstream runs. There is no expiry: a paused run waits indefinitely.
4
Somebody continues it
If the step has form fields, the task carries an action that opens the form. Submitting it resumes the run with the answers, and a comment on the task names who answered. Otherwise, or in addition, a paused run shows a green Continue button on the Monitoring page. It opens a dialog with one field — a message to pass as the output of the paused step — and resuming restarts the run from that step.To resume through the API (
POST /hub/workflows/run), pass the run’s full tracking ID as run_id, in the form ms.hub.run.<uuid>.<flow subject>, and the response as trigger. A bare run uuid is rejected with 400, and a run that isn’t paused or errored returns 409.What the step returns
The values from the task form, or exactly what the person typed into the Continue dialog. With form fields, the result is the object the form produces. Through Continue, the step imposes no shape on it: there is noapproved flag, no reviewer, no comments and no timestamp. If a later step needs to branch on a decision, the resumer has to supply it and you have to read it back yourself.
Resuming a run that is not paused, for example one already answered, is refused with a
409. A second submit of the same form is refused too.$.resume, to any step after the Checkpoint. $.trigger is untouched by the resume and still holds the payload that started the run.
$.resume exists only on a run that was resumed, and it is set whether the run was continued from a pause or retried after an error. On a run that has never been resumed, reading it gives [].What it does not do
Finding paused runs
Monitoring counts paused runs separately and can filter to them. A paused run’s detail panel offers Continue (resume from the paused step) and Rerun (start again from the beginning with a new trigger). Both are also available on a run that has errored.Editing a flow changes its draft. Publish to make a change take effect. A run already paused resumes on the configuration it was paused with, not on whatever has been published since.
Next Steps
Condition Step
Route on the decision that came back
Assistant Step
An assistant can park a run for a person too
Flow Steps Overview
How a run moves between steps
Delay Step
Wait on a clock instead of a person