Referencia de la APIDivisions
Add the knockout («Eliminatorias») after a category’s group stage (needs the `manage` scope)
Adds a knockout round after the category’s group stage, keeping every group game, group and result. The category’s last round must be a group stage, and it must have no knockout yet: a second call is a 409 DIVISION_ALREADY_HAS_ELIMINATION. The new round is not set up: its draw comes from previewDraw and applyDraw. Answers the new round. Optional Idempotency-Key header. Recorded in «Actividad».
Authorization
apiToken AuthorizationBearer <token>
API token (organization or personal)
In: header
Path Parameters
idx*string
Tournament identifier
Format
uuiddivisionIdx*string
Category identifier
Format
uuidHeader Parameters
Idempotency-Key?string
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
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
curl -X POST "https://example.com/v1/external/tournaments/497f6eca-6276-4993-bfeb-53cbbbba6f08/divisions/497f6eca-6276-4993-bfeb-53cbbbba6f08/rounds/append" \ -H "Content-Type: application/json" \ -d '{ "numberOfSets": 2 }'{ "round": { "idx": "a9b0c1d2-e3f4-4567-8a81-920314253647", "name": "Pool Play", "label": { "es": "Fase de Grupos", "en": "Group stage" }, "type": "ROUND_ROBIN_ROUND", "number": 1, "isSetup": true, "isVisible": true, "gamesPerTeam": 3, "gamesRequireWinners": true, "numberOfSets": 3, "proSets": false, "playAllSets": false, "pointsPerSet": 11, "placements": [ 1, 2 ], "playEachTeamOnce": true, "trueDoubleEliminationRound": null, "numQualifiers": null, "drawSize": null, "hasNextRoundTransitioned": false, "createdAt": "2026-08-20T10:55:00.000Z", "division": { "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b", "name": "Primera Varonil" }, "pools": [ { "idx": "d6e7f8a9-b0c1-4234-8d5e-6f7081920314", "name": "Grupo A", "number": 1, "teams": [ { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" } ], "standings": [ { "idx": "c5d6e7f8-a9b0-4123-8c4d-5e6f70819203", "rank": 1, "awardedPoints": 250, "team": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" }, "teamStats": { "idx": "b4c5d6e7-f8a9-4012-8b3c-4d5e6f708192", "points": 9, "wins": 3, "losses": 1, "ties": 0, "cancelled": 0, "forfeits": 0, "pointsFor": 24, "pointsAgainst": 15, "setsPointsFor": 7, "setsPointsAgainst": 3, "totalGamesPlayed": 4, "pointsDifference": 9, "setsPointsDifference": 4 } } ] } ], "games": [ { "idx": "a3b4c5d6-e7f8-4901-8a2b-3c4d5e6f7081", "number": 7, "displayNumber": 7, "status": "FINISHED", "time": "2026-09-12T16:00:00.000Z", "lengthInMinutes": 90, "courtNumber": 2, "matchDay": 1, "roundDetail": "Grupo A", "scheduleNumber": 14, "sectionNumber": 1, "isRetirement": false, "isDoubleForfeit": false, "retiredTeamId": null, "liveStartedAt": null, "resultApprovalStatus": "PENDING", "submittedAt": null, "homeTeamDetails": { "label": "Winner of Game 3", "labelEs": "Ganador del juego 3", "teamNumber": 2, "poolNumber": 1, "poolRank": 1, "sourceGameNumber": 3, "sourceResult": "WINNER" }, "awayTeamDetails": { "label": "Winner of Game 3", "labelEs": "Ganador del juego 3", "teamNumber": 2, "poolNumber": 1, "poolRank": 1, "sourceGameNumber": 3, "sourceResult": "WINNER" }, "createdAt": "2026-08-20T11:02:00.000Z", "homeTeam": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" }, "awayTeam": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" }, "winner": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" }, "court": { "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90", "name": "Cancha 1", "position": 1 }, "score": { "idx": "f2a3b4c5-d6e7-4890-8f1a-2b3c4d5e6f70", "home": 2, "away": 1, "playerPointsBalanced": null, "extraTime": null, "penalties": null, "decisionMethod": "REGULATION", "sets": [ { "idx": "e1f2a3b4-c5d6-4789-8e0f-1a2b3c4d5e6f", "home": 6, "away": 4, "number": 1, "isTieBreak": false } ] } } ], "draws": [ { "idx": "f8a9b0c1-d2e3-4456-8f70-819203142536", "placement": 1, "rounds": [ { "idx": "e7f8a9b0-c1d2-4345-8e6f-708192031425", "label": "Semifinal", "order": 2, "games": [ { "idx": "a3b4c5d6-e7f8-4901-8a2b-3c4d5e6f7081", "number": 7, "displayNumber": 7, "status": "FINISHED", "time": "2026-09-12T16:00:00.000Z", "lengthInMinutes": 90, "courtNumber": 2, "matchDay": 1, "roundDetail": "Grupo A", "scheduleNumber": 14, "sectionNumber": 1, "isRetirement": false, "isDoubleForfeit": false, "retiredTeamId": null, "liveStartedAt": null, "resultApprovalStatus": "PENDING", "submittedAt": null, "homeTeamDetails": { "label": "Winner of Game 3", "labelEs": "Ganador del juego 3", "teamNumber": 2, "poolNumber": 1, "poolRank": 1, "sourceGameNumber": 3, "sourceResult": "WINNER" }, "awayTeamDetails": { "label": "Winner of Game 3", "labelEs": "Ganador del juego 3", "teamNumber": 2, "poolNumber": 1, "poolRank": 1, "sourceGameNumber": 3, "sourceResult": "WINNER" }, "createdAt": "2026-08-20T11:02:00.000Z", "homeTeam": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" }, "awayTeam": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" }, "winner": { "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Lugo / Ramirez" }, "court": { "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90", "name": "Cancha 1", "position": 1 }, "score": { "idx": "f2a3b4c5-d6e7-4890-8f1a-2b3c4d5e6f70", "home": 2, "away": 1, "playerPointsBalanced": null, "extraTime": null, "penalties": null, "decisionMethod": "REGULATION", "sets": [ { "idx": "e1f2a3b4-c5d6-4789-8e0f-1a2b3c4d5e6f", "home": 6, "away": 4, "number": 1, "isTieBreak": false } ] } } ] } ] } ] }}