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 required

Required API key issued by Preciser.

Leaguestring required

Required tenant/database selector, for example pitchbio-master.

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

Changed in 1 of the 10 revisions of this API.42

Aug 27, 20269b0abde08b0642See the full diff
- ▲
  the header request parameter League became required
  request-parameter-became-required
- ▲
  the header request parameter x-api-key became required
  request-parameter-became-required
- ▲
  header request parameter League list-of-types was narrowed by removing types null
  request-parameter-list-of-types-narrowed
- ▲
  header request parameter x-api-key list-of-types was narrowed by removing types null
  request-parameter-list-of-types-narrowed
- ○
  for the header request parameter League, the type/format was generalized from / to string/
  request-parameter-type-generalized
- ○
  for the header request parameter x-api-key, the type/format was generalized from / to string/
  request-parameter-type-generalized

Full history