Submit a video

Submit a video from your backend using x-api-key and the League header (glory-league for Glory League). Keep the API key on your server. The JWT used to open Stats Breakdown is not a substitute for these API headers.

Choose a submission flow

• One-shot (Glory League): include home_team_name, away_team_name, home_team_color, and away_team_color together. For a new video with an available credit, the API copies the source into Mux, charges one video credit, and starts processing. The response is HTTP 200 with status: "processing"; Stats Breakdown skips the Video Info form. No separate call to POST /api/v1/videos/{video_uuid}/info is required.
• Two-phase (Glory League): submit the video before all four game-info fields are available. For a new video with an available credit, the API copies the source into Mux, reserves one credit without spending it, and returns HTTP 200 with status: "pending". Later, provide all four fields through POST /api/v1/videos/{video_uuid}/info, either from your backend with the required endpoint permission or through the Stats Breakdown form. That step charges the reserved credit and starts processing. Cancelling before info is submitted releases the reservation; cancellation after processing starts does not refund the credit.

Quota and retries

• No available video quota: HTTP 200, status: "payment_required". No submission is created and no source URL check or Mux ingest is performed. After purchasing credits, repeat POST /api/v1/videos with the same video_uuid. /info cannot create the missing submission.
• Existing video_uuid: HTTP 200 with the existing status. This is a read-only retry: it does not check the source URL, reserve/charge another credit, create another Mux asset, or overwrite game info or return_url. Repeating this POST with additional fields does not complete a pending submission; use /api/v1/videos/{video_uuid}/info instead.
• Malformed input, authentication/authorization failures, inaccessible video sources, and service errors still return the appropriate non-200 status. HTTP 200 means a recognized routing outcome, not that processing has finished.

Follow progress

Open the existing Stats Breakdown URL or call GET /api/v1/videos/{video_uuid}/status. The status response reports info_required: true while a pending submission still needs game info. This flag is returned by /status, not by this submit response. Completion and failure can also be received through separately registered video.completed and video.failed webhooks.

When VIDEO_ENDPOINTS_LIVE is false, this endpoint returns a preview response without creating a submission or starting processing.