Get one action run

GET

https://api.cloudraker.com/spaces/:spaceId/runs/:runId

GET

/spaces/:spaceId/runs/:runId

curl https://api.cloudraker.com/spaces/spaceId/runs/runId \
     -H "Authorization: Bearer <token>"

200Retrieved

{
  "data": {
    "id": "run_01J…",
    "spaceId": "string",
    "actionSlug": "extract-structured",
    "actionVersion": 1,
    "installedActionId": "string",
    "playbookRunId": "string",
    "status": "running",
    "error": "string",
    "artifacts": [
      {
        "id": "string",
        "kind": "string",
        "title": "string",
        "url": "string",
        "open": "tab"
      }
    ],
    "awaitingInput": [
      {
        "id": "string",
        "title": "string",
        "url": "string",
        "resolved": true
      }
    ],
    "documents": [
      {
        "fileId": "string",
        "name": "string",
        "contentType": "string"
      }
    ],
    "outputs": [
      {
        "fileId": "string",
        "kind": "string",
        "key": "string",
        "size": 1.1
      }
    ],
    "timeoutSeconds": 1,
    "lastEventAt": "2024-01-15T09:30:00Z",
    "createdAt": "2024-01-15T09:30:00Z",
    "createdBy": "string",
    "finishedAt": "2024-01-15T09:30:00Z"
  }
}

Fetches a single run by id within the space. Requires space:read (denied → 404); a runId belonging to another space also 404s. Returns 200 { data: ActionRun } with the run’s status (running | awaiting_input | done | failed), error, output, documents (input files), outputs (downloadable byproducts — each fileId streams via getRunOutput), artifacts (rendered links) and awaitingInput. Callers who lack space:contribute get capability fields (URLs, storage references, and artifacts) redacted.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

runIdstringRequired

Response

The run.

dataobject