List Investigators | Resemble

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

Return all six managed investigators available to the authenticated team. Use an agent’s uuid identifier to 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 investigator entry. The complete response contains all six agents and returns count: 6.

{
  "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 investigator 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`	Investigator 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 investigator 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 investigators and does not accept pagination or filtering parameters. Agent order is managed by Resemble.