---
title: "Get investigation run"
method: GET
path: "/agents/{uuid}/runs/{run_id}"
tags: ["detectAgents"]
---

# Get investigation run

`GET /agents/{uuid}/runs/{run_id}`

Retrieve a persisted investigation run, including its replay transcript
and the exact configuration and memory snapshots used by the investigation.

## Path parameters

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

## Headers

- `Authorization` string, required

## Response `200`

Investigation run details

- DetectAgentsGetDetectAgentInvestigationRunResponse200
  - `success` boolean, required
  - `item` DetectAgentRun, required
    - `uuid` string, uuid, required — Investigation run identifier.
    - `status` 'running' | 'completed' | 'error', required
    - `result` DetectAgentRunResult, required — Compact result summary derived from the investigation transcript.
      - `verdict` DetectAgentRunResultVerdict
        - `forced` boolean
        - `excerpt` string
      - `recommended_action` string, nullable
      - `confidence` number, double, nullable
      - `label` string, nullable
      - `score` number, double, nullable
      - `agent_ran` boolean, nullable
    - `inputs` DetectAgentRunSummaryInputs, required — Submitted investigation inputs. Null-valued fields are omitted.
      - `query` string
      - `url` string, uri
      - `filename` string
      - `check_urls` string
    - `has_media` boolean, required — Whether primary uploaded media is attached to this run.
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `transcript` object[] — Public investigation events. Internal cost events are omitted.
    - `config_snapshot` object — Exact managed configuration used for the investigation.
    - `memory_before` string
    - `memory_after` string
    - `error` string, nullable
    - `media_url` string, nullable — Relative URL for uploaded primary media, or null when the run used a public URL.

## Other responses

- `401` — Missing or invalid API key
- `403` — The account does not have Detect Agents access
- `404` — Detect Agent or investigation run not found
- `502` — Detect Agents service unavailable

## Changes

- **2026-08-12** `adf3ebc25178` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/resemble/apis/api-reference/changes/agents/:uuid/runs/:run_id/get.md)

---

[API](https://skmtc.dev/resemble/apis/api-reference.md) · [All operations](https://skmtc.dev/resemble/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resemble/api-reference/revisions/e93597a6b425/schema)