Sign in

v1

latestOpenAPI 3.1.02026-08-0410576180.0 KB
Games

Upsert Game

Upsert a game record.

Inserts a new game or updates an existing one based on video_id. If game_id is not provided, a UUID will be auto-generated.

post/api/v1/games

Headers

x-api-keystring nullable
Leaguestring nullable

Request body

game_idstring uuid required

Game ID (must be a valid UUID)

home_team_idstring uuid required

Home team identifier (must be a valid UUID)

away_team_idstring uuid required

Away team identifier (must be a valid UUID)

seasonstring required

Season (e.g., '2026')

season_typestring required

Season type (e.g., 'regular season', 'playoffs')

scheduled_date_timestring date-time required

Scheduled game date and time (must include timezone, e.g., '2026-02-01T19:00:00+11:00' for Australia/Melbourne)

venuestring nullable

Game venue

game_statusstring required

Game status (e.g., 'scheduled', 'in progress', 'completed')

Example request

{
  "away_team_id": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
  "game_id": "550e8400-e29b-41d4-a716-446655440000",
  "game_status": "scheduled",
  "home_team_id": "60959335-3173-45b4-b656-276a05b22011",
  "scheduled_date_time": "2026-02-01T19:00:00+11:00",
  "season": "2026",
  "season_type": "regular season",
  "venue": "Arena Center"
}

Response

Successful Response

successboolean required

Whether the operation was successful

messagestring required

Status message

video_idstring required

The internal identifier of the created game record