Skip to navigation

Get Workflow

Fetch a single workflow by ID.

Returns the full workflow including its definition (graph nodes/edges and execution config), aggregate run stats, and the latest run status. The definition is returned with any backwards-compatible config migrations applied, so node configs always reflect the current schema even if the workflow was saved with an older version.

Use GET /workflows to list multiple workflows without fetching their full definitions, or GET /workflows?include_definition=true to list them with the same migrated definition this route returns.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response
dataobject
metaobject

Errors

422
Unprocessable Entity Error