Referencia de la APIDivisions
Apply the previewed format to a category (needs the `manage` scope)
Applies exactly the format previewDivisionFormat showed, in ONE write: the kept rounds keep their games and results, the replaced ones go with their games, groups, standings and draws, and the new ones are created empty. Takes only the confirmationToken the preview answered; the plan is computed again, and a category that changed since the preview is a 409 PREVIEW_STALE with nothing written (preview again). Answers the category with its rounds. 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
application/json
application/json
curl -X POST "https://example.com/v1/external/tournaments/497f6eca-6276-4993-bfeb-53cbbbba6f08/divisions/497f6eca-6276-4993-bfeb-53cbbbba6f08/format" \ -H "Content-Type: application/json" \ -d '{ "confirmationToken": "eyJ2IjoxLCJraW5kIjoicm91bmQucG9vbHMifQ.c2lnbmF0dXJl" }'{ "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b", "name": "Primera Varonil", "number": 1, "color": "#1E3A8A", "isDoubles": true, "isVisible": true, "price": 1200, "minParticipants": null, "maxParticipants": null, "maxRegistrations": 32, "createdAt": "2026-08-01T16:44:00.000Z", "tournament": { "idx": "f6a7b8c9-d0e1-4234-8f5a-6b7c8d9e0f1a" }, "rounds": [ { "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 } ] } } ] } ] } ] } ], "teams": [ { "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 } } ], "circuitCategory": { "idx": "b2c3d4e5-f6a7-4890-8b1c-2d3e4f5a6b7c", "name": "Primera Fuerza", "gender": "MIXED", "color": "#1E3A8A" }}