The Platform API

Processing Pipeline

Manage your videos, ask questions, and build applications with the Platform API. Explore the operations below for request details, responses, and examples.

Processing Pipeline

The processing pipeline runs an AI agent on uploaded content. It can be triggered automatically after the content scan or video processing, or manually via API. The agent produces a structured report with decision, confidence, and detailed findings.

POST/api/v1/projects/:projectId/pipeline/trigger/:videoIdTrigger pipeline for video

Trigger pipeline for video

Manually triggers the agent pipeline for a specific video. Returns immediately with a queue confirmation.

// Response
{
  "queued": true,
  "videoId": "VIDEO_ID",
  "projectId": "PROJECT_ID",
  "message": "Processing queued"
}

GET/api/v1/projects/:projectId/videos/:videoId/reportGet agent report

Get agent report

Returns the full agent analysis report for a video. Returns 404 if no report exists yet.

{
  "data": {
    "run_id": "run-uuid",
    "started_at": "2026-02-23T10:30:00Z",
    "completed_at": "2026-02-23T10:30:45Z",
    "duration_ms": 45000,
    "decision": "flag",
    "confidence": 85,
    "summary": "Content contains potentially violent scenes requiring review",
    "findings": [
      {
        "type": "policy_violation",
        "category": "violence",
        "severity": "medium",
        "timestamp": 14.5,
        "description": "Physical altercation between two individuals"
      }
    ],
    "agent": {
      "iterations": 5,
      "tokens_used": { "input": 8500, "output": 1200 },
      "cost_at": 980
    }
  }
}

GET/api/v1/projects/:projectId/pipeline/configGet pipeline configuration

Get pipeline configuration

{
  "data": {
    "enabled": true,
    "auto_trigger": "manual",
    "prompt": "Analyze this content for policy violations...",
    "timeout_ms": 600000
  }
}

PUT/api/v1/projects/:projectId/pipeline/configBetaUpdate pipeline configuration

Update pipeline configuration

Beta: this operation may change before it is final.

Merges provided fields into existing config. Omitted fields are preserved.

{
  "enabled": true,
  "auto_trigger": "manual",
  "prompt": "Your custom analysis instructions..."
}

auto_trigger: use "manual" to run analysis on request, or "after_processing" to run it after a video is processed.