Withdraw a team («Baja»), applying exactly the previewed plan (needs the `manage` scope)
Applies the plan previewTeamWithdrawal showed, in ONE write: the W.O.s, the passes, the cancelled registration and the cleared seed, and it closes the team’s pending partner invites and unpaid payment links (a payment already made is not touched); a game the preview marked RECORD_LATER is left as it is. Takes only the confirmationToken the preview answered; the plan is computed again, and a tournament that changed since the preview is a 409 PREVIEW_STALE with nothing written (preview again). The team stays in the standings with its played results; its plan place is not freed. No email is sent. Optional Idempotency-Key header. Recorded in «Actividad».
Authorization
apiToken API token (organization or personal)
In: header
Path Parameters
Tournament identifier
uuidTeam identifier
uuidHeader Parameters
Optional. A unique string (1-255 visible ASCII characters) per intended write, sent again unchanged when retrying THAT write: for 24 h the same key with the same request answers the first answer again (Idempotency-Replayed: true) instead of writing twice. The same key with another request is a 422 IDEMPOTENCY_KEY_REUSED; while the first still runs, a 409 IDEMPOTENCY_IN_PROGRESS (Retry-After). A 429 or a 409 TOURNAMENT_BUSY is never stored: retry with the same key.
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
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" \ -H "Content-Type: application/json" \ -d '{ "confirmationToken": "eyJ2IjoxLCJraW5kIjoidGVhbS53aXRoZHJhdyJ9.c2lnbmF0dXJl" }'{ "team": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez", "seed": 3, "seedNumber": 1, "club": "Club Deportivo Santa Fe", "picture": "https://cdn.setto.io/teams/lugo-ramirez.png", "description": "Campeones 2025", "ranking": 12, "isWildCard": false, "qualifierStatus": "COMPETING", "drawAssignment": "QUALIFYING", "withdrawn": false, "createdAt": "2026-08-01T17:30:00.000Z", "division": { "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b", "name": "Primera Varonil" }, "players": [ { "idx": "c9d0e1f2-a3b4-4567-8c8d-9e0f1a2b3c4d", "firstName": "Mario", "lastName": "Lugo", "avatar": "https://cdn.setto.io/avatars/mario-lugo.png" } ], "captainProfileIdx": "c9d0e1f2-a3b4-4567-8c8d-9e0f1a2b3c4d", "leagueTeam": { "idx": "d0e1f2a3-b4c5-4678-8d9e-0f1a2b3c4d5e", "name": "Club Santa Fe", "color": "#1E3A8A", "logo": "https://cdn.setto.io/league-teams/santa-fe.png", "position": 1, "pointsAdjustment": 0 } }, "registrationStatus": "CANCELLED", "forfeited": [ { "gameIdx": "e1f2a3b4-c5d6-4789-8e0f-2a3b4c5d6e7f", "number": 7, "winner": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" } } ], "awaitingOpponent": [ { "gameIdx": "f2a3b4c5-d6e7-4890-8f0a-3b4c5d6e7f8a", "number": 12, "via": null, "outcome": "BYE_ON_ARRIVAL" } ], "resolvedByes": [ { "gameIdx": "a3b4c5d6-e7f8-4901-8a1b-4c5d6e7f8a9b", "number": 15, "via": "e1f2a3b4-c5d6-4789-8e0f-2a3b4c5d6e7f", "winner": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" } } ], "kept": 2}