API docs v1
Aggregator API · v1

Delete Freerounds

Cancel unused rounds for one player and game, and understand unsupported bulk operations.

POST/v1/commandsdeleteFreeRoundsIdempotency key required
On 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.

json
{
  "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:

json
{ "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.