Skip to main content
PATCH
Override backfill state (server-authoritative)

Authorizations

api-key
string
header
required

Path Parameters

instance_id
string
required

Server instance ID (the game server's own INSTANCE_ID).

Body

application/json

Server-authoritative override of a match's backfill state.

accepting
boolean
required

Whether the match should accept backfill joiners. Set false to close backfill (server-authoritative override).

skillBand
object | null

Replace the match's skill band for joiners. Omit to leave the current band unchanged; null is treated as no change.

Response

Backfill state updated. The roster mirror and roster_version reflect the change.

Result of a server-authoritative backfill state change.

match_id
string
required

Identifier of the match that was updated.

instance_id
string | null
required

Server instance backing this match.

status
enum<string>
required

Match lifecycle status after the update.

Available options:
in_game,
locked,
completed
backfill_open
boolean
required

Whether the match is now accepting backfill joiners.

backfill_deadline
string<date-time> | null
required

ISO 8601 timestamp after which backfill closes. Null if no window is active.

skill_band
object | null
required

Current skill band applied to joiners, or null if none.

roster_version
integer
required

Monotonically increasing roster version after the update.