List Investigators | Resemble

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

Return the seven Resemble catalog investigators, followed by the authenticated team’s active custom investigators. Use an investigator’s uuid to inspect it, run an investigation, or retrieve its run history.

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 catalog investigator. The complete response lists the seven catalog investigators first and then the team’s custom investigators, so count is 7 plus the number of custom investigators.

{
  "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": 7
}

Response Fields

Field	Type	Description
`id`	`string`	Stable investigator identifier, the same as `uuid`.
`uuid`	`string`	Identifier used by the detail, run, and history endpoints: the `preset_id` for a catalog investigator, a UUID for a custom one.
`name`	`string`	Investigator display name.
`description`	`string \| null`	Verification workflow handled by the investigator.
`preset_id`	`string \| null`	Catalog investigator identifier, or `null` for a custom investigator.
`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 investigator.
`tagline`	`string \| null`	Short description derived from the investigator’s instructions.
`display`	`object \| null`	Curated catalog metadata such as audience, outcome, and features. `null` for a custom investigator.
`activated`	`boolean`	Whether the team has initialized backing state for this investigator by running it.
`created_at`	`string \| null`	ISO 8601 timestamp for the team’s backing state, or `null` before the investigator’s first run.
`updated_at`	`string \| null`	ISO 8601 timestamp for the team’s backing state, or `null` before the investigator’s first run.

This endpoint returns every catalog investigator and the team’s active custom investigators, and does not accept pagination or filtering parameters. Catalog order is managed by Resemble.