---
title: "Get a Runner run"
method: GET
path: "/api/v1/runs/{forge}/{owner}/{repo}/{runId}"
tags: ["Runs"]
---

# Get a Runner run

`GET /api/v1/runs/{forge}/{owner}/{repo}/{runId}`

## Path parameters

- `forge` 'gh' | 'et', required
- `owner` string, required
- `repo` string, required
- `runId` string, required

## Response `200`

Runner run detail

- object
  - `run` object, required
    - `id` string, required
    - `provider` string, nullable, required
    - `repo_id` string, nullable, required
    - `repo_full_name` string, required
    - `ref` string, nullable, required
    - `agent` string, nullable, required
    - `environment_id` string, nullable, required
    - `session_id` string, nullable, required
    - `snapshot_name` string, nullable, required
    - `snapshot_source` 'base' | 'warm', nullable, required
    - `status` 'creating' | 'ready' | 'prompting' | 'succeeded' | 'failed' | 'timeout' | 'canceled' | 'deleted', required
    - `error_message` string, nullable, required
    - `automation` string, nullable, required
    - `trail_id` string, nullable, required
    - `head_sha` string, nullable, required
    - `setup_id` string, nullable, required
    - `credential_source` 'platform' | 'repo', nullable, required
    - `runtime_kind` 'sandbox' | 'inline', required
    - `scope_type` 'repo' | 'no_repo', required
    - `scope_json` unknown, required
    - `output_config` object, nullable, required
      - `adapter` 'json' | 'last_json_line' | 'markdown' | 'score' | 'none', required
      - `resultType` string, nullable, required
      - `scoreField` string, nullable, required
      - `trailsReviewEnabled` boolean
    - `execution_config` object, nullable, required
      - `model` string, nullable, required
      - `thinking_effort` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `deleted_at` string, nullable, required
    - `trail` object, nullable, required
      - `id` string, required
      - `number` integer, required
      - `title` string, required
      - `status` string, nullable, required
      - `branch` string, nullable, required
      - `gh_pr_id` integer, nullable, required
    - `setup` object, nullable, required
      - `id` string, required
      - `runner_id` string, required
      - `name` string, nullable, required
      - `pinned` boolean, required
      - `created_at` string, required
      - `updated_at` string, required
  - `latestPrompt` object, nullable, required
    - `id` string, required
    - `run_id` string, required
    - `prompt` string, nullable, required
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'canceled', required
    - `stop_reason` string, nullable, required
    - `error_message` string, nullable, required
    - `queued_at` string, required
    - `started_at` string, nullable, required
    - `completed_at` string, nullable, required
  - `prompts` object[], required
    - `id` string, required
    - `run_id` string, required
    - `prompt` string, nullable, required
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'canceled', required
    - `stop_reason` string, nullable, required
    - `error_message` string, nullable, required
    - `queued_at` string, required
    - `started_at` string, nullable, required
    - `completed_at` string, nullable, required
  - `events` object[], required
    - `event_index` integer, required
    - `run_id` string, required
    - `prompt_id` string, nullable, required
    - `source` 'session' | 'app', required
    - `event_type` string, required
    - `session_id` string, nullable, required
    - `session_event_id` string, nullable, required
    - `session_event_index` integer, nullable, required
    - `connection_id` string, nullable, required
    - `sender` 'client' | 'agent', nullable, required
    - `payload` unknown, required
    - `created_at` string, required
  - `automationResult` object, nullable, required
    - `id` string, nullable, required
    - `run_id` string, required
    - `automation` string, required
    - `result_type` string, required
    - `data` unknown, required
    - `created_at` string, required
    - `updated_at` string, nullable, required
  - `previewUrl` string, nullable, required
  - `inspectorUrl` string, nullable, required

## Other responses

- `404` — Run not found

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entire/apis/entire-api/revisions/d69a682d6e44?raw)