Skip to main content
GET
/
api
/
v1
/
runs
/
{id}
Get a run
curl --request GET \
  --url https://studio.eigenpal.com/api/v1/runs/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "finished": true,
  "sampleRank": 0.5,
  "timing": {
    "createdAt": "<string>",
    "startedAt": "<string>",
    "completedAt": "<string>",
    "durationMs": 123,
    "cancelRequestedAt": "<string>"
  },
  "source": {
    "id": "<string>",
    "name": "<string>",
    "version": "<string>",
    "versionId": "<string>",
    "slug": "<string>",
    "model": "<string>",
    "git": {
      "requestedRef": "<string>",
      "resolvedRef": "<string>",
      "resolvedTag": "<string>",
      "commitSha": "<string>"
    },
    "implementationAvailable": true,
    "automationFound": true,
    "currentVersion": "<string>"
  },
  "trigger": {
    "type": "<string>",
    "by": {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>"
    },
    "email": "<unknown>"
  },
  "execution": {
    "schemaValid": true,
    "batchId": "<string>",
    "retry": {
      "number": 123,
      "previousRunId": "<string>",
      "nextRun": {
        "id": "<string>",
        "status": "<string>"
      }
    },
    "review": {
      "hasNote": true,
      "correctionCount": 0
    }
  },
  "eval": {
    "example": "<string>",
    "score": 123,
    "passed": true,
    "exampleId": "<string>"
  },
  "output": {},
  "files": [
    {
      "name": "<string>",
      "role": "<string>",
      "path": "<string>",
      "stepName": "<string>",
      "contentType": "<string>",
      "size": 0
    }
  ],
  "error": "<string>",
  "input": {
    "args": "<unknown>",
    "files": [
      {
        "name": "<string>"
      }
    ],
    "metadata": "<unknown>"
  },
  "usage": {
    "tokens": {
      "input": 123,
      "output": 123,
      "cacheRead": 123,
      "cacheWrite": 123
    },
    "creditsCharged": 123,
    "durationMs": 123,
    "llmCallCount": 123,
    "ocrPagesProcessed": 123,
    "agentTurns": 123
  },
  "debug": {
    "observability": "<unknown>",
    "traceId": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API key issued from Settings → API Keys. Pass as Authorization: Bearer <key>.

Path Parameters

​
id
string
required

Run id

Query Parameters

​
expand
string

Optional sections: input, usage, execution, debug. Terminal runs always include top-level output, files, and error.

Response

Run detail. Expanded sections appear only when requested.

​
id
string
required
​
type
enum<string>
required
Available options:
workflow,
agent
​
finished
boolean
required

True when the run has reached a terminal status.

​
sampleRank
number
required

Deterministic pseudo-random rank in [0, 1) for this run within the tenant. Use with a sample rate threshold to review a stable subset.

Required range: 0 <= x <= 1
​
timing
object
required
​
source
object
required
​
trigger
object
required
​
execution
object
required

Slim execution metadata always present. Pass expand=execution to replace with full RunExecution (WorkflowRunExecution or AgentRunExecution depending on run type).

​
eval
object

Present only when the run is eval-scoped.

​
output
object

Completed runs only.

​
files
object[]

Completed runs only. Download with GET /api/v1/runs/:id/artifacts/:path.

​
error
string | null

Terminal failure message. Null when the run succeeded or is still in flight.

​
input
object

expand=input.

​
usage
object

expand=usage. Null for old runs without telemetry.

​
debug
object

expand=debug.