Videos

Submit Video Info

Changed on

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

Request

  • Base URL
    https://developer.preciser.io
  • URL
    https://developer.preciser.io/api/v1/videos/{video_uuid}/info
  • Auth
    none declared. Required headers: x-api-key, League

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

Jersey color as 3- or 6-digit HEX (with or without '#') or a supported case-insensitive jersey-palette name: white, black, red, blue, navy, sky blue, dark green, green, yellow, gold, orange, purple, maroon, gray, charcoal, brown, pink, teal, silver, beige. Names use the DMS jersey palette, not CSS values (e.g. blue/royal blue = #4169E1, green = #31A531, gray/grey/light gray = #D3D3D3). Normalized to #RRGGBB for processing; named inputs are also saved separately with surrounding whitespace trimmed.

away_team_colorstring required

Jersey color as 3- or 6-digit HEX (with or without '#') or a supported case-insensitive jersey-palette name: white, black, red, blue, navy, sky blue, dark green, green, yellow, gold, orange, purple, maroon, gray, charcoal, brown, pink, teal, silver, beige. Names use the DMS jersey palette, not CSS values (e.g. blue/royal blue = #4169E1, green = #31A531, gray/grey/light gray = #D3D3D3). Normalized to #RRGGBB for processing; named inputs are also saved separately with surrounding whitespace trimmed.

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

  • 9b0abde08b06Revision changes
    • breaking

      the header request parameter League became required

    • breaking

      the header request parameter x-api-key became required

    • breaking

      header request parameter League list-of-types was narrowed by removing types null

    • breaking

      header request parameter x-api-key list-of-types was narrowed by removing types null

    • info

      for the header request parameter League, the type was generalized from no type to string

    • info

      for the header request parameter x-api-key, the type was generalized from no type to string