SETTO API

Preview a group stage’s groups («Configurar grupos») and their games (writes nothing)

POST
/v1/external/tournaments/{idx}/rounds/{roundIdx}/pools/preview

Splits the category’s accepted teams (a confirmed registration, or added by the organizer) into numberOfPools groups («Grupo A», «Grupo B», …) as the dashboard does, and writes nothing: seeds («cabezas de serie») go to separate groups, the rest by lot, reproducible with rngSeed (the preview answers the one it used). pins then places a team in a given group («mueve a Los Tigres al Grupo B»). Lists every group with its teams, every game (gamesPerTeam per team, «¿Cuántos partidos por equipo?», or everyone once), and what the apply replaces: the round’s current groups and games and the knockout games built from them. Withdrawn, pending and rejected teams never enter. Answers a confirmationToken (15 minutes) to send unchanged to applyPools once the organizer approved these exact groups. Needs only the read scope.

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Path Parameters

idx*string

Tournament identifier

Formatuuid
roundIdx*string

Round identifier: a group stage

Formatuuid

Request 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/rounds/497f6eca-6276-4993-bfeb-53cbbbba6f08/pools/preview" \  -H "Content-Type: application/json" \  -d '{    "numberOfPools": 2  }'
{  "round": {    "idx": "3f1a2b3c-4d5e-4f60-8123-456789abcdef",    "label": {      "es": "Fase de Grupos",      "en": "Group stage"    },    "divisionIdx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",    "divisionName": "4a varonil"  },  "plan": {    "rngSeed": 20261107,    "numberOfPools": 2,    "gamesPerTeam": null,    "pools": [      {        "number": 1,        "name": "Grupo A",        "teams": [          {            "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",            "name": "Pérez / López",            "seed": 1          }        ]      }    ],    "games": [      {        "number": 1,        "pool": "Grupo A",        "home": {          "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",          "name": "Lugo / Ramirez"        },        "away": {          "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",          "name": "Lugo / Ramirez"        }      }    ],    "replaced": {      "pools": 0,      "games": 0,      "knockoutGames": 0    }  },  "confirmationToken": "eyJ2IjoxLCJraW5kIjoicm91bmQucG9vbHMifQ.c2lnbmF0dXJl",  "expiresAt": "2027-03-14T15:15:00.000Z"}