Skip to content

Pause a Workflow

How do I stop Daily invoice digest for a week while finance changes the invoice format? Pause the workflow. Its Live version starts no new runs until you resume it, and nothing about its triggers, release, or agents changes.

  • Triggers: each event is still recorded, but it starts no run. Events that arrive while paused are not run later when you resume.
  • Agents: an agent that calls the workflow as a tool is told This workflow is paused by its owner. It will not run until the owner resumes it.
  • API and assistants: a Live run through the workflow API or run_flow is refused with status 409.
  • Runs that already started finish.
  • Development runs and tests, so you can fix the workflow while it is paused.
  • Publishing. A new release goes Live but the workflow stays paused.

Only the owner can pause or resume, and only a published workflow can be paused.

In the app: open Workflows and turn off the switch on the workflow’s card, then confirm Pause workflow. The card dims while it is paused. Turn the switch back on to resume; that applies immediately. In the workflow builder, open the menu next to the workflow’s name and choose Pause or Resume.

With an assistant: call workflow_set_paused with the workflow’s ID as a string:

{ "workflowId": "<workflowId>", "paused": true }

The result reports paused, pausedAt, and whether the call changed anything. Send "paused": false to resume. workflow_status reports paused alongside active.

To stop a single trigger and leave the rest of the workflow running, disable that trigger and publish instead.