List an automation's runs
Returns the automation's runs, newest first, each expanded with its per-node executions. Requires the `automations:read` permission plus view access to the automation. Pass `limit` to change the page size; it defaults to 30 and is capped at 100.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Query Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/automations/string/runs"{ "data": [ { "id": "string", "automationId": "string", "automationVersionId": "string", "workspaceId": "string", "status": "queued", "source": "manual", "startedAt": "string", "completedAt": "string", "triggerPayload": {}, "output": {}, "error": "string", "metadata": {}, "startNodeId": "string", "replayOfRunId": "string", "nodeRuns": [ { "id": "string", "runId": "string", "nodeId": "string", "nodeKind": "string", "scopeKey": "string", "status": "queued", "attempt": 0, "input": {}, "output": {}, "error": "string", "startedAt": "string", "completedAt": "string" } ] } ]}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Run an automation starting from one node
Queues a run that begins at `nodeId`, optionally against a specific `automationVersionId` and pre-seeded with `scope` and per-node `nodes` context so a single branch can be exercised. Requires the `automations:write` permission plus edit access; a version belonging to another automation is rejected with a validation error, and without an explicit version the automation must be published and enabled. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
List automation runs across the whole workspace
Returns runs for every automation in the workspace in one stream, newest first, for the workspace runs page. Requires the `automations:read` permission. Narrow the result with a comma-separated `statuses` list and page by passing `beforeStartedAt` and `beforeId` from the last row of the previous page; an unrecognized status, or one cursor field without the other, is rejected as a query validation error.