---
title: "List Detect Agents"
method: GET
path: "/agents"
tags: ["detectAgents"]
---

# List Detect Agents

`GET /agents`

Return all six managed Detect Agents available to the authenticated team.
Use an agent's `uuid` to run an investigation or retrieve its run history.
This endpoint does not accept pagination or filtering parameters.

## Headers

- `Authorization` string, required

## Response `200`

All six Detect Agents

- DetectAgentsListDetectAgentsResponse200
  - `success` boolean, required
  - `items` DetectAgent[], required
    - `id` string, required — Stable Detect Agent identifier. Currently the same as `uuid` and `preset_id`.
    - `uuid` string, required — Stable identifier used by the run and history endpoints.
    - `preset_id` string, required — Resemble-managed Detect Agent identifier.
    - `name` string, required
    - `description` string, nullable — Verification workflow handled by the Detect Agent.
    - `tier` 'triage' | 'investigation' | 'forensic', required — Managed investigation depth. Informational and read-only.
    - `memory_preview` string, required — Read-only preview of patterns learned from previous investigations.
    - `capabilities` DetectAgentCapabilities, required — Read-only feature flags for a managed Detect Agent.
      - `media` boolean, required
      - `reverse_search` boolean, required
      - `identity` boolean, required
      - `grounding` boolean, required
      - `structured` boolean, required
      - `tools` boolean, required
      - `knowledge` boolean, required
    - `tagline` string, nullable — Short description derived from the Detect Agent's managed instructions.
    - `activated` boolean, required — Whether this team has initialized backing state for the Detect Agent by running it.
    - `created_at` string, date-time, nullable — Team backing-state creation time, or null before the first investigation.
    - `updated_at` string, date-time, nullable — Team backing-state update time, or null before the first investigation.
  - `count` integer, required

## Other responses

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

## Changes

- **2026-08-12** `adf3ebc25178` — 2 warning, 21 info
  - deleted the `query` request parameter `advanced`
  - deleted the `query` request parameter `phone_number`
  - api operation id `list-agents` removed and replaced with `list-detect-agents`
  - api tag `detectAgents` added
  - …19 more

[Change history](https://skmtc.dev/resemble/apis/api-reference/changes/agents/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)