Investigator

Investigator provides six managed, ready-to-run media-authenticity investigators. Each agent is designed for a specific verification workflow and combines Resemble Detect evidence with an evidence-based assessment.

Choose an investigator, submit uploaded media or a public URL, and consume the investigation as a Server-Sent Events (SSE) stream. Completed and failed investigations are persisted so you can retrieve their results later.

Base URL

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

All requests require an API key:

Authorization: Bearer YOUR_API_KEY

Your account must have Investigator access. An authenticated account without access receives 403 Forbidden.

Available Investigators

We offer six investigators that you can use out of the box.

Agent profiles are managed by Resemble. GET /agents always returns all six profiles. When a team runs a profile for the first time, its backing state is initialized automatically.

Public API Scope

The first public release is a read-and-run API. Investigators and their configurations are managed by Resemble.

You can:

• List all six investigators available to your team
• Run an investigation with an investigator
• List an agent’s investigation runs
• Retrieve a specific investigation run

The supported public contract does not include creating, updating, archiving, or deleting investigators. Agent configuration, tier, and memory are also outside the supported public contract.

Typical Workflow

1. List Investigators and select the agent that matches your verification workflow.
2. Save its uuid agent identifier and run an investigation against a file or public URL.
3. Consume the SSE stream for live evidence and the final assessment.
4. Use the returned run_id to retrieve the persisted run, or list the agent’s recent runs.

Investigator Shape

GET /agents returns read-only metadata for all six investigators. Agent names, capabilities, and ordering are controlled by Resemble and may evolve over time, so use the API response as the source of truth.

interface DetectAgent {
  id: string; // Stable agent identifier; currently the same as uuid and preset_id
  uuid: string;
  name: string;
  description: string | null;
  preset_id: string;
  tier: "triage" | "investigation" | "forensic";
  memory_preview: string;
  capabilities: {
    media: boolean;
    reverse_search: boolean;
    identity: boolean;
    grounding: boolean;
    structured: boolean;
    tools: boolean;
    knowledge: boolean;
  };
  tagline: string | null;
  activated: boolean;
  created_at: string | null;
  updated_at: string | null;
}

Investigation Run Shape

Run-list responses return compact summaries. A run-detail response also includes the replay transcript and audit snapshots recorded during the investigation.

interface DetectAgentRun {
  uuid: string;
  status: "running" | "completed" | "error";
  result: {
    verdict?: { forced?: boolean; excerpt?: string };
    recommended_action?: string | null;
    confidence?: number | null;
    label?: string | null;
    score?: number | null;
    agent_ran?: boolean | null;
  };
  inputs: {
    query?: string;
    url?: string;
    filename?: string;
    check_urls?: string;
  };
  has_media: boolean;
  created_at: string | null;
  updated_at: string | null;
  transcript?: Array<Record<string, unknown>>;
  config_snapshot?: Record<string, unknown>;
  memory_before?: string;
  memory_after?: string;
  error?: string | null;
  media_url?: string | null;
}

Endpoints

• GET /agents — List all six investigators
• POST /agents/{uuid}/run — Stream an investigation
• GET /agents/{uuid}/runs — List an agent’s recent runs
• GET /agents/{uuid}/runs/{run_id} — Get a persisted run