> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.resemble.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.resemble.ai/_mcp/server.

# List Detect Agents

`GET https://app.resemble.ai/api/v2/agents`

Return all six managed Detect Agents available to the authenticated team. Use an agent's `uuid` identifier to run an investigation or retrieve its run history.

```bash
curl --request GET 'https://app.resemble.ai/api/v2/agents' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

## Response

The example below abbreviates the `items` array to one Detect Agent entry. The complete response contains all six agents and returns `count: 6`.

```json
{
  "success": true,
  "items": [
    {
      "id": "verify_id",
      "uuid": "verify_id",
      "name": "Verify an ID",
      "description": "Verify a government-issued identity document and the person presenting it.",
      "preset_id": "verify_id",
      "tier": "forensic",
      "memory_preview": "(memory is empty - no patterns learned yet)",
      "capabilities": {
        "media": true,
        "reverse_search": true,
        "identity": true,
        "grounding": true,
        "structured": true,
        "tools": true,
        "knowledge": false
      },
      "tagline": "You operate inside an IDENTITY-VERIFICATION workflow.",
      "activated": true,
      "updated_at": "2026-08-11T16:45:00Z",
      "created_at": "2026-08-10T09:15:00Z"
    }
  ],
  "count": 6
}
```

## Response Fields

| Field            | Type             | Description                                                                                       |
| ---------------- | ---------------- | ------------------------------------------------------------------------------------------------- |
| `id`             | `string`         | Stable Detect Agent identifier. Currently the same as `uuid` and `preset_id`.                     |
| `uuid`           | `string`         | Stable agent identifier used by the run and history endpoints. Currently the same as `preset_id`. |
| `name`           | `string`         | Detect Agent display name.                                                                        |
| `description`    | `string \| null` | Verification workflow handled by the agent.                                                       |
| `preset_id`      | `string`         | Resemble-managed agent identifier.                                                                |
| `tier`           | `string`         | Managed investigation depth. Informational and read-only.                                         |
| `memory_preview` | `string`         | Read-only preview of patterns learned from previous runs.                                         |
| `capabilities`   | `object`         | Read-only feature flags describing the agent.                                                     |
| `tagline`        | `string \| null` | Short description derived from the agent's managed instructions.                                  |
| `activated`      | `boolean`        | Whether the team has initialized backing state for this Detect Agent by running it.               |
| `created_at`     | `string \| null` | ISO 8601 timestamp for the team's backing state, or `null` before the agent's first run.          |
| `updated_at`     | `string \| null` | ISO 8601 timestamp for the team's backing state, or `null` before the agent's first run.          |

This endpoint returns all six Detect Agents and does not accept pagination or filtering parameters. Agent order is managed by Resemble.