v2

latestOpenAPI 3.1.02026-08-0810576180.4 KB
Videos

Submit Video

Submit a video for AI processing.

When VIDEO_ENDPOINTS_LIVE is False, returns a preview response without DB writes.

post/api/v1/videos

Headers

x-api-keystring nullable
Leaguestring nullable

Request body

video_uuidstring uuid nullable

Client-provided video UUID (auto-generated if omitted)

org_idstring required

Account uuid to charge the credit to (billing is per end user). Get it from POST /api/v1/accounts/lookup, or mint it yourself.

org_namestring required

The end user's email — the account's lookup handle. Send it with every submit: an unknown org_id whose email is known resolves to that existing account instead of opening a second one.

jwtstring nullable

Short-lived token Glory League issued for this user; stored for reference when the account is first seen.

user_idstring nullable

ID of the user submitting the video (for tracking)

video_urlstring required

URL to retrieve the video

home_team_uuidstring uuid nullable

Home team UUID (optional for URL-only submissions)

home_team_namestring

Home team name

home_team_scoreinteger nullable

Home team score

away_team_uuidstring uuid nullable

Away team UUID (optional for URL-only submissions)

away_team_namestring

Away team name

away_team_scoreinteger nullable

Away team score

billing_tierstring nullable

Billing tier identifier

game_datestring nullable

Game date (YYYY-MM-DD)

descriptionstring

Game/venue description

home_team_colorstring

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

away_team_colorstring

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

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 status

created_atstring date-time required

Timestamp of submission