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

# List investigation runs

`GET /agents/{uuid}/runs`

Return up to 100 of a Detect Agent's most recent investigation runs in
newest-first order. An agent that the team has never run returns an empty list.

## Path parameters

- `uuid` string, required

## Headers

- `Authorization` string, required

## Response `200`

Recent investigation runs

- DetectAgentsListDetectAgentInvestigationRunsResponse200
  - `success` boolean, required
  - `items` DetectAgentRunSummary[], 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
  - `count` integer, required

## Other responses

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

---

[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)