---
title: "Run investigation"
method: POST
path: "/agents/{uuid}/run"
tags: ["detectAgents"]
---

# Run investigation

`POST /agents/{uuid}/run`

Run a managed Detect Agent against uploaded media or a public URL.
The response is a live Server-Sent Events stream. The first `run_started`
event contains the persisted run identifier.

## Path parameters

- `uuid` string, required

## Headers

- `Authorization` string, required

## Response `200`

Response with status 200

- object

## Other responses

- `401` — Missing or invalid API key
- `402` — The investigation is blocked by billing or available credits
- `403` — The account does not have Detect Agents access
- `404` — Detect Agent not found
- `422` — Neither `file` nor `url` was provided
- `502` — Detect Agents service unavailable before streaming begins

---

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