Videos

Submit Video Info

Complete a URL-only submission with its game info and start processing.

Called by the Preciser Stats Breakdown page (JWT-gated BFF) after the end user fills the video info form. The initial submit reserved a credit; this endpoint finalizes that charge only after the info is committed, then creates the video records and kicks off PBP-AI. 404 when no submission exists, 409 when the info was already provided or the submission is past 'pending'.

post/api/v1/videos/{video_uuid}/info

Path parameters

video_uuidstring required

Headers

x-api-keystring nullable
Leaguestring nullable

Request body

home_team_namestring required

Home team name

away_team_namestring required

Away team name

home_team_colorstring required

Home team jersey color (hex, e.g. '#FF0000')

away_team_colorstring required

Away team jersey color (hex, e.g. '#0000FF')

game_datestring nullable

Game date (YYYY-MM-DD)

descriptionstring

Game/venue description

home_team_uuidstring uuid nullable

Home team UUID (kept from submit when omitted)

away_team_uuidstring uuid nullable

Away team UUID (kept from submit when omitted)

home_team_scoreinteger nullable

Home team score

away_team_scoreinteger nullable

Away team score

user_idstring nullable

End-user id (overrides the one stored at submit)

Response

Successful Response

successboolean required

Whether the submission was successful

video_uuidstring required

Stable video identifier for status/results calls. Echoes the caller's video_uuid, or contains the server-generated UUID when it was omitted.

messagestring required

Status message

statusstring required

Current processing/routing status. payment_required means no submission was created and Stats Breakdown should show checkout.

created_atstring date-time required

Timestamp of submission

Changes