Skip to main content

Get Speaker Face Match Suggestions Route

GET 
/v2/videos/{video_id}/speaker-face-match/suggestions

Return the stored speaker-face match suggestions for a video.

One item per in-scope speaker. Unresolved speakers have face_id and accuracy null and a reasoning explaining why. Never includes the internal match_evidence dict.

404 when no suggestions block exists (no run yet, in-flight after a trigger cleared the previous block, or after face/speaker add/delete/merge invalidation). A completed run that resolved nothing still 200s with all-null rows.

Auth matches the trigger POST: owner or admin only.

Error Responses​

  • 401 Unauthorized: User is not authenticated or not authorized to access this video
  • 404 Not Found: Video not found, or no suggestions block is stored

Request​

Responses​

Successful Response