---
title: "Retrieve"
method: GET
path: "/v4/runs/{run_id}"
tags: ["Runs"]
---

# Retrieve

`GET /v4/runs/{run_id}`

Retrieve the details of a run.

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- ClusterRunResult — Base model for schemas.
  - `inputs` PipelineCloudSchemasRunsRunInput[]
    - `type` 'integer' | 'string' | 'fp' | 'dictionary' | 'boolean' | 'none' | 'array' | 'pkl' | 'file' | 'stream', required — An enumeration.
    - `value` unknown
    - `file_name` string
    - `file_path` string
    - `file_url` string
  - `outputs` PipelineCloudSchemasRunsRunOutput[]
    - `type` 'integer' | 'string' | 'fp' | 'dictionary' | 'boolean' | 'none' | 'array' | 'pkl' | 'file' | 'stream', required — An enumeration.
    - `value` unknown
    - `file` PipelineCloudSchemasRunsRunOutputFile — Base model for schemas.
      - `name` string, required
      - `path` string, required
      - `url` string
      - `size` integer, required
  - `error` ContainerRunError — Base model for schemas.
    - `type` 'input_error' | 'cuda_oom' | 'cuda_error' | 'oom' | 'pipeline_error' | 'startup_error' | 'pipeline_loading' | 'timeout' | 'unknown', required — An enumeration.
    - `message` string, required
    - `traceback` string
  - `id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `pipeline_id` string, required
  - `state` 'created' | 'routing' | 'queued' | 'running' | 'completed' | 'failed' | 'no_resources_available' | 'node_preempted' | 'unknown', required — An enumeration.
  - `queue_position` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mystic/apis/mystic-api.md) · [All operations](https://skmtc.net/mystic/apis/mystic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mystic/mystic-api/versions/60e569344994/schema)