Run investigation

Run a managed Detect Agent 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 token from https://app.resemble.ai/account/api

Path parameters

uuidstringRequired

Stable Detect Agent 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 Detect Agent 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