Delete Freerounds
Cancel unused rounds for one player and game, and understand unsupported bulk operations.
/v1/commandsdeleteFreeRoundsIdempotency key requiredOn this page
Cancel one player and game#
deleteFreeRounds cancels unused rounds for the specified player, currency, and game. Scope: proxy:deleteFreeRounds or proxy:*. Send a persisted Idempotency-Key.
{
"method": "deleteFreeRounds",
"gameid": "12/737",
"user_username": "player-1001",
"currency": "USD"
}Use the same identity and actual catalogue game ID as the grant. The game and currency must remain entitled. On acknowledged success, the normalized response is:
{ "error": 0 }A cancellation does not reverse already settled rounds. On an unknown outcome, reconcile before retrying with a new key.
Unsupported operations#
getFreeRounds and deleteAllFreeRounds remain recognized compatibility methods but are not supported by the current connection. They return a nonzero numeric application error; do not rely on them to list or cancel grants.
Their compatibility header policies still apply: getFreeRounds rejects Idempotency-Key; deleteAllFreeRounds requires it. Exact-game restrictions also prohibit bulk deletion. Track your own grant acknowledgements and settlement records.