Runs and Executions
Inspect runs, executions, activity streams, public run surfaces, and resume or cancel work.
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/activity/stream | Stream org activity events |
GET | /v1/executions | List executions for the current organization |
POST | /v1/executions | Create an execution for a workflow |
GET | /v1/executions/{id} | Get a single execution by ID |
GET | /v1/executions/{id}/events | Get events for an execution |
GET | /v1/executions/{id}/stream | Stream execution updates |
GET | /v1/executions/stats | Get external execution stats for an organization |
GET | /v1/executions/stream | Stream org execution updates |
GET | /v1/public/executions/{id} | Get the current status and event timeline for a public execution |
GET | /v1/public/executions/{id}/stream | Stream public execution updates |
GET | /v1/public/runs/{id} | Get a public run by ID |
GET | /v1/public/runs/by-tx/{txHash} | Find a run by trigger transaction hash (no auth required) |
GET | /v1/runs | List all runs |
POST | /v1/runs | Execute an inline workflow definition (ephemeral run). The definition must use "manual" trigger type. No workflow is saved — the definition is executed once and the run is recorded with workflowId="". Requires WorkflowCreate permission. |
GET | /v1/runs/{id} | Get a specific run by ID |
POST | /v1/runs/{id}/cancel | Cancel a running or waiting run |
POST | /v1/runs/{id}/nodes/{nodeId}/resume | Resume a waiting node in a workflow run |
POST | /v1/runs/{id}/retry | Retry a failed or cancelled run from its failure point |
GET | /v1/runs/{id}/stream | Stream run execution events |
GET | /v1/runs/{runId}/variable-writes | Variable writes for a run |
GET | /v1/runs/status-counts | Count all runs in the caller's organization, grouped by status. Optional since (RFC3339) restricts to runs started at or after that instant. |
GET | /v1/runs/status-counts/by-workflow | Count runs in the caller's organization grouped by workflow and status, sorted by total runs descending. Optional since (RFC3339) restricts to runs started at or after that instant. |
POST | /v1/runs/sync | Execute a workflow definition synchronously. Blocks until all nodes complete and returns the full execution state. Max 60s timeout, 20 nodes. |
POST | /v1/runs/tx-attribution | Batch run transaction attribution |