Get Investigator | Resemble

GET https://app.resemble.ai/api/v2/agents/{uuid}

Retrieve one investigator, including its memory and, for a custom investigator, its skills.

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

Path Parameters

Parameter	Type	Required	Description
`uuid`	`string`	Yes	Investigator identifier returned by List Investigators: a catalog `preset_id` such as `verify_id`, or a custom investigator’s UUID.

Response

The example below is a custom investigator with one skill. A catalog investigator returns the same fields without skills.

{
  "success": true,
  "item": {
    "id": "3f2a9c1e-7b4d-4e8a-9c2f-1d5e6a7b8c90",
    "uuid": "3f2a9c1e-7b4d-4e8a-9c2f-1d5e6a7b8c90",
    "name": "ID Verification",
    "description": "Verifies government-issued IDs for forgery, tampering and synthetic media.",
    "preset_id": null,
    "tier": "investigation",
    "memory_preview": "(memory is empty - no patterns learned yet)",
    "capabilities": {
      "media": true,
      "reverse_search": true,
      "identity": false,
      "grounding": true,
      "structured": true,
      "tools": true,
      "knowledge": false
    },
    "tagline": "You verify government-issued identity documents.",
    "display": null,
    "activated": true,
    "updated_at": "2026-11-02T16:13:08Z",
    "created_at": "2026-10-28T22:24:03Z",
    "memory": "# Detect Harness Memory\n",
    "config": {
      "structured": true,
      "send_media": true
    },
    "skills": [
      {
        "name": "canada-id-documents",
        "description": "Use for Canadian identity documents: passport, provincial driver's licences and photo ID cards, and the Permanent Resident card.",
        "body": "Canadian ID checks. These are plausibility checks, not proof of issuance. ...",
        "enabled": true,
        "position": 0
      }
    ]
  }
}

Response Fields

The item has every field returned by List Investigators, plus:

Field	Type	Description
`memory`	`string`	The investigator’s long-term memory document, in markdown.
`config`	`object`	Configuration the investigator runs with. Read-only; its shape is not part of the supported contract.
`skills`	`array`	Custom investigators only. The investigator’s skills, in order.
`skills[].name`	`string`	Skill name: lowercase letters, digits, and hyphens.
`skills[].description`	`string`	One line saying when the agent should open the skill.
`skills[].body`	`string`	The playbook the agent reads when the skill applies.
`skills[].enabled`	`boolean`	Whether runs include the skill.
`skills[].position`	`integer`	Order of the skill in the list.

Skills are created and edited in the Resemble app. The API returns them read-only, and runs include a custom investigator’s enabled skills automatically.

Errors

Status	Description
`401 Unauthorized`	Missing or invalid API key.
`403 Forbidden`	The account does not have Investigator access.
`404 Not Found`	The investigator is unknown, archived, or owned by another team.