---
title: "Get Run"
method: GET
path: "/workspaces/{workspace_id}/copilot/runs/{run_id}"
tags: ["copilot"]
---

# Get Run

`GET /workspaces/{workspace_id}/copilot/runs/{run_id}`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/workspaces/{workspace_id}/copilot/runs/{run_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `workspace_id` string, uuid, required
- `run_id` string, uuid, required

## Response `200`

Successful Response

- CopilotRun
  - `id` string, uuid, required
  - `conversation_id` string, uuid, required
  - `question` string, nullable, required
  - `background` boolean, required
  - `state` union, required
    - 'running' | 'failed'
    - 'answered' | 'awaiting_approval' | 'step_limit' | 'switched_off' | 'upstream_error' | 'refused' | 'cancelled' | 'budget' | 'interrupted'
  - `model` string, required
  - `cost_usd` string, required
  - `reserved_usd` string, required
  - `cancel_requested_at` string, date-time, nullable, required
  - `error` string, nullable, required
  - `created_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required
  - `turn` TurnOut, required
    - `id` string, uuid, required
    - `run_id` string, uuid, required
    - `conversation_id` string, uuid, required
    - `status` 'answered' | 'awaiting_approval' | 'step_limit' | 'switched_off' | 'upstream_error' | 'refused' | 'cancelled' | 'budget' | 'interrupted', required
    - `answer` string, nullable, required
    - `evidence` CopilotEvidence[], required
      - `label` string, required
      - `arguments` object, required
      - `ids` string[], required
    - `proposals` union[], required
      - union
        - CopilotProposal
          - `kind` 'training_run', required
          - `reason` string, required
          - `input` object, required
          - `quote` object, required
          - `proposal_id` string, uuid, nullable
          - `plan_sha256` string, nullable
          - `max_usd` string, nullable
          - `expires_at` string, nullable
        - CopilotPipelineProposal
          - `kind` 'pipeline_change', required
          - `id` string, uuid, required
          - `sha256` string, required
          - `diff` object[], required
          - `rationale` string, required
    - `ungrounded_ids` string[], required
    - `web` CopilotWeb[], required
      - `step` integer, required
      - `tool` 'web_search' | 'web_fetch', required
      - `query` string, nullable
      - `url` string, nullable
      - `urls` string[], nullable
      - `error` string, nullable
      - `retrieved_at` string, nullable
    - `memory` CopilotMemoryWrite[], required
      - `scope` 'user' | 'workspace', required
      - `action` 'write' | 'delete', required
      - `file` string, required
      - `content` string, nullable, required
    - `approvals` CopilotApproval[], required
      - `tool_call_id` string, required
      - `kind` 'memory' | 'dataset_version' | 'big_box' | 'training_run', required
      - `scope` 'user' | 'workspace', nullable, required
      - `action` 'write' | 'delete', nullable, required
      - `arguments` object, required
    - `cost_usd` string, required
    - `model` string, required
  - `waiting_on_computer` boolean, required

## Other responses

- `422`: Validation Error

---

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