> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs and Executions

Inspect runs, executions, activity streams, public run surfaces, and resume or cancel work.

| Method | Endpoint                                                                                                       | Description                                                                                                                                                                                                                                    |
| ------ | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GET`  | [/v1/activity/stream](/api/reference/get-v1-activity-stream)                                                   | Stream org activity events                                                                                                                                                                                                                     |
| `GET`  | [/v1/executions](/api/reference/get-v1-executions)                                                             | List executions for the current organization                                                                                                                                                                                                   |
| `POST` | [/v1/executions](/api/reference/post-v1-executions)                                                            | Create an execution for a workflow                                                                                                                                                                                                             |
| `GET`  | [/v1/executions/&#123;id&#125;](/api/reference/get-v1-executions-id-)                                          | Get a single execution by ID                                                                                                                                                                                                                   |
| `GET`  | [/v1/executions/&#123;id&#125;/events](/api/reference/get-v1-executions-id-events)                             | Get events for an execution                                                                                                                                                                                                                    |
| `GET`  | [/v1/executions/&#123;id&#125;/stream](/api/reference/get-v1-executions-id-stream)                             | Stream execution updates                                                                                                                                                                                                                       |
| `GET`  | [/v1/executions/stats](/api/reference/get-v1-executions-stats)                                                 | Get external execution stats for an organization                                                                                                                                                                                               |
| `GET`  | [/v1/executions/stream](/api/reference/get-v1-executions-stream)                                               | Stream org execution updates                                                                                                                                                                                                                   |
| `GET`  | [/v1/public/executions/&#123;id&#125;](/api/reference/get-v1-public-executions-id-)                            | Get the current status and event timeline for a public execution                                                                                                                                                                               |
| `GET`  | [/v1/public/executions/&#123;id&#125;/stream](/api/reference/get-v1-public-executions-id-stream)               | Stream public execution updates                                                                                                                                                                                                                |
| `GET`  | [/v1/public/runs/&#123;id&#125;](/api/reference/get-v1-public-runs-id-)                                        | Get a public run by ID                                                                                                                                                                                                                         |
| `GET`  | [/v1/public/runs/by-tx/&#123;txHash&#125;](/api/reference/get-v1-public-runs-by-tx-tx-hash-)                   | Find a run by trigger transaction hash \(no auth required\)                                                                                                                                                                                    |
| `GET`  | [/v1/runs](/api/reference/get-v1-runs)                                                                         | List all runs                                                                                                                                                                                                                                  |
| `POST` | [/v1/runs](/api/reference/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/&#123;id&#125;](/api/reference/get-v1-runs-id-)                                                      | Get a specific run by ID                                                                                                                                                                                                                       |
| `POST` | [/v1/runs/&#123;id&#125;/cancel](/api/reference/post-v1-runs-id-cancel)                                        | Cancel a running or waiting run                                                                                                                                                                                                                |
| `POST` | [/v1/runs/&#123;id&#125;/nodes/&#123;nodeId&#125;/resume](/api/reference/post-v1-runs-id-nodes-node-id-resume) | Resume a waiting node in a workflow run                                                                                                                                                                                                        |
| `POST` | [/v1/runs/&#123;id&#125;/retry](/api/reference/post-v1-runs-id-retry)                                          | Retry a failed or cancelled run from its failure point                                                                                                                                                                                         |
| `GET`  | [/v1/runs/&#123;id&#125;/stream](/api/reference/get-v1-runs-id-stream)                                         | Stream run execution events                                                                                                                                                                                                                    |
| `GET`  | [/v1/runs/&#123;runId&#125;/variable-writes](/api/reference/get-v1-runs-run-id-variable-writes)                | Variable writes for a run                                                                                                                                                                                                                      |
| `GET`  | [/v1/runs/status-counts](/api/reference/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](/api/reference/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](/api/reference/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](/api/reference/post-v1-runs-tx-attribution)                                          | Batch run transaction attribution                                                                                                                                                                                                              |