Override backfill state (server-authoritative)
Lets an advanced game server take control of its match’s backfill. Set accepting to open or close backfill joiners, and optionally replace the skillBand that gates joiners.
This is an optional override — the engine manages backfill automatically for modes with backfill enabled. Use this only when the game server has better knowledge of when it can accept joiners (e.g., between rounds).
Requires a server API key (pf_...).
Authorizations
Path Parameters
Server instance ID (the game server's own INSTANCE_ID).
Body
Server-authoritative override of a match's backfill state.
Response
Backfill state updated. The roster mirror and roster_version reflect the change.
Result of a server-authoritative backfill state change.
Identifier of the match that was updated.
Server instance backing this match.
Match lifecycle status after the update.
in_game, locked, completed Whether the match is now accepting backfill joiners.
ISO 8601 timestamp after which backfill closes. Null if no window is active.
Current skill band applied to joiners, or null if none.
Monotonically increasing roster version after the update.