SETTO API

Preview a team’s withdrawal («Baja»): every game and what happens to it (writes nothing)

POST
/v1/external/tournaments/{idx}/teams/{teamIdx}/withdraw/preview

Lists what withdrawTeam would do, and writes nothing: the games already played (their results stay), and every unplayed game with its consequence — FORFEIT (a W.O. for the rival the game names), BYE_ON_ARRIVAL (a knockout game whose rival is still to be decided: that rival passes through when it arrives), BYE_NOW (a placement game, such as third place, left without its loser: a pass for the team already there), RECORD_LATER (a game whose rival comes from a group placement, is withdrawn or is missing: it is left for the organizer to record, and nothing is written for it). The team stays in the standings with its results, its registration becomes cancelled, and its plan place is not freed. Answers a confirmationToken (15 minutes) to send unchanged to withdrawTeam once the organizer approved this exact plan. No body; needs only the read scope.

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Path Parameters

idx*string

Tournament identifier

Formatuuid
teamIdx*string

Team identifier

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/external/tournaments/497f6eca-6276-4993-bfeb-53cbbbba6f08/teams/497f6eca-6276-4993-bfeb-53cbbbba6f08/withdraw/preview"
{  "team": {    "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",    "name": "Pérez / Ruiz",    "divisionIdx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",    "divisionName": "4a varonil"  },  "plan": {    "registrationStatus": "PENDING",    "played": [      {        "gameIdx": "d0e1f2a3-b4c5-4678-9d0e-1f2a3b4c5d6e",        "number": 3,        "roundLabel": {          "es": "Fase de Grupos",          "en": "Group stage"        },        "opponent": {          "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",          "name": "Lugo / Ramirez"        },        "status": "FINISHED",        "pendingApproval": false      }    ],    "decided": [      {        "gameIdx": "e1f2a3b4-c5d6-4789-8e0f-2a3b4c5d6e7f",        "number": 7,        "roundLabel": {          "es": "Fase de Grupos",          "en": "Group stage"        },        "opponent": {          "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",          "name": "Lugo / Ramirez"        },        "consequence": "FORFEIT",        "via": null      }    ]  },  "confirmationToken": "eyJ2IjoxLCJraW5kIjoidGVhbS53aXRoZHJhdyJ9.c2lnbmF0dXJl",  "expiresAt": "2027-03-14T15:15:00.000Z"}