Skip to main content
POST
Register a Team HQ Live Activity

Authorizations

Authorization
string
header
required

Clerk session token. Use Authorization: Bearer .

Path Parameters

gameId
string
required

Body

application/json
teamId
string
required

Must be the fixture's homeTeamId or awayTeamId. Decides the card theme and the minted activityId.

platform
string
default:ios

ios writes a LiveActivityRegistration row and returns activityId/expiresAt. android returns 200 success-nothing-to-register (platform android, null activityId/expiresAt, no row written) after the same game/team/consent checks — Android Live Updates ride ordinary push subscriptions and need no registration. Any other value is 400 VALIDATION_ERROR.

pushToken
string | null

Accepted and persisted but INERT — never read by dispatch. Exists only for a possible future direct-APNs migration.

Response

Registered (iOS), or success-nothing-to-register (Android, platform android + null activityId/expiresAt, no row written)

success
enum<boolean>
required
Available options:
true
data
object
required

iOS registration