Workflow Definitions

Workflows coordinate approved operations into a durable multi-step process. A definition has versions that can be inspected and planned before a run begins.

Lifecycle

  1. Create a definition with POST /workflows.
  2. Read or update it with GET or PATCH /workflows/{workflow}.
  3. Inspect versions with GET /workflows/{workflow}/versions.
  4. Inspect a version or request a plan with GET /workflows/{workflow}/versions/{version} and POST /workflows/{workflow}/versions/{version}/plan.
  5. Start work with POST /workflows/{workflow}/runs.

Related

Last updated: July 10, 2026