Skip to main content

Workflow Management

You can view and manage your durable workflow executions via a web UI (self-hosted, DBOS Cloud), programmatically, or via command line.

Listing Workflows​

You can list your application's workflows programmatically via DBOS.list_workflows or from the command line with dbos workflow list.

You can also view a searchable and expandable list of your application's workflows from its page on the DBOS Console (either self-hosted or on DBOS Cloud).

Workflow List

Listing Workflow Steps​

You can list the steps of a workflow programmatically via DBOS.list_workflow_steps or from the command line with dbos workflow steps.

You can also visualize a workflow's execution graph (including the workflow, its steps, and its child workflows and their steps) from its page on the DBOS Console (either self-hosted or on DBOS Cloud). For example, here is the graph of a workflow that processes multiple tasks concurrently by enqueueing child workflows:

Workflow List

Listing Enqueued Workflows​

You can list all currently enqueued workflows and steps of your application via DBOS.list_queued_workflows or from the command line with dbos workflow queue list.

You can also view a searchable and expandable list of your application's currently enqueued workflows and steps from its page on the DBOS Console (either self-hosted or on DBOS Cloud).

Workflow List

Cancelling Workflows​

You can cancel the execution of a workflow from the web UI, programmatically via DBOS.cancel_workflow, or through the command line with dbos workflow cancel.

If the workflow is currently executing, cancelling it preempts its execution (interrupting it at the beginning of its next step). If the workflow is enqueued, cancelling removes it from the queue.

Resuming Workflows​

You can resume a workflow from its last completed step from the web UI, programmatically via