Skip to main content
POST
Assign an official to a position

Authorizations

Authorization
string
header
required

Partner API key: Authorization: Bearer whk_…. Keys are issued by the Whistle team (email tommy@huddleup-sports.com), shown once at issuance, and bound to your source namespace — they access only your leagues (plus explicit grants) and your webhook endpoints. Any auth failure returns 401 {"error":"unauthorized"}; the API never returns 403 — out-of-scope resources answer 404 exactly like nonexistent ones.

Path Parameters

gameId
string
required

Whistle game id (id from game responses).

Body

application/json
userId
string

Whistle user id. Takes precedence.

externalId
string

Your id for the official. Identifies who to assign — does NOT make this call idempotent.

source
string

Derived from your key — omit, or echo your key's source; any other value returns 400 source_mismatch.

positionId
string

Optional; defaults to the first open position.

Response

Game detail after assignment

data
object

Same as Game but each position embeds official and payment. A position's official is independent of its status — a cancelled slot can retain its official (no-show record).

Last modified on July 13, 2026