Passo Developers
Api

Get a video version's AI analysis

GET
/video-versions/{versionId}/analysis

Returns the newest AI analysis run for a video version in a workspace you belong to. The analysis is advisory — it never gates the human review state or a sign-off. JSON: id, versionId, status (pending, processing, completed, failed, skipped), overallResult (pass, fail, or null — the advisory verdict, independent of status), the four quality scores 0–10 (overall, audio, visual, engagement; null until the vision step runs), modelProvider, error (on the failed path), createdAt, completedAt, and issues — the timestamped observations, errors first then by timeline position, each with category (quality, content), severity (error, warning, info), startMs/endMs (both null = whole video, startMs alone = a point), title, description, suggestedFix, confidence (0–1), dismissedAt, dismissedByUserId, convertedCommentId, and createdAt — and transcript, the cleaned transcript as whole sentences with ms anchors on the same timeline as the issues (each: id, text, startMs, endMs), or null until the transcript has been cleaned (a pending, transcript-only, or skipped run has none). 404 if the version has no analysis or you can't see it.

Authorization

AuthorizationBearer <token>

A Supabase-issued OAuth user access token. On collection endpoints, pair with a Passo-Workspace header to pick a workspace.

In: header

Path Parameters

versionId*string
Length1 <= length

Response Body

application/json

curl -X GET "https://example.com/video-versions/string/analysis"
{  "id": "string",  "versionId": "string",  "status": "pending",  "overallResult": "pass",  "qualityScoreOverall": 0,  "qualityScoreAudio": 0,  "qualityScoreVisual": 0,  "qualityScoreEngagement": 0,  "modelProvider": "string",  "error": "string",  "createdAt": "string",  "completedAt": "string",  "issues": [    {      "id": "string",      "category": "quality",      "severity": "error",      "startMs": -9007199254740991,      "endMs": -9007199254740991,      "title": "string",      "description": "string",      "suggestedFix": "string",      "confidence": 0,      "dismissedAt": "string",      "dismissedByUserId": "string",      "convertedCommentId": "string",      "createdAt": "string"    }  ],  "transcript": [    {      "id": "string",      "text": "string",      "startMs": -9007199254740991,      "endMs": -9007199254740991    }  ]}