Run investigation | Resemble

Run a managed investigator against uploaded media or a public URL. The response is a live Server-Sent Events stream. The first run_started event contains the persisted run identifier.

Authentication

AuthorizationBearer

API key from https://app.resemble.ai/hub/api

Path parameters

uuidstringRequired

Stable investigator identifier returned by GET /agents.

Request

This endpoint expects a multipart form with multiple files.

filefileOptional

Primary media to analyze. Required when url is omitted.

urlstringOptionalformat: "uri"

Public media URL to analyze. Required when file is omitted.

querystringOptional

Question or investigation objective.

evidence[]filesOptional

Supporting evidence files. Repeat this field for multiple files.

check_urlsstringOptional

Additional URLs for the investigator to check.

Response

This endpoint returns an object.

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

502

Bad Gateway Error