---
title: "Run intelligence"
method: POST
path: "/intelligence"
tags: ["intelligence"]
---

# Run intelligence

`POST /intelligence`

Analyze audio, image, or video for comprehensive insights. Optionally reference an existing detect to associate.

## Headers

- `Authorization` string, required

## Request body

- object
  - `media_token` string — Token for uploaded media file (from secure upload)
  - `url` string, uri — HTTPS URL to audio, image, or video file
  - `detect_id` string, uuid — UUID of an existing detect to associate
  - `media_type` 'audio' | 'video' | 'image' — Explicit media type (auto-detected if not provided)
  - `callback_url` string, uri — URL that receives the final intelligence payload via HTTP POST. When present, the request runs asynchronously and returns 202 Accepted.

## Response `200`

Intelligence analysis

- IntelligenceRunIntelligenceResponse200
  - `success` boolean
  - `item` IntelligencePostResponsesContentApplicationJsonSchemaItem
    - `uuid` string
    - `created_at` string, date-time
    - `detect_uuid` string — UUID of the associated detect object
    - `media_type` 'audio' | 'video' | 'image' — Type of media analyzed

---

[API](https://skmtc.dev/resemble/apis/api-reference.md) · [All operations](https://skmtc.dev/resemble/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resemble/api-reference/revisions/e93597a6b425/schema)