SETTO API

Preview a knockout’s draw («Configurar eliminatorias»): its first round (writes nothing)

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

Builds the knockout’s first round as «Configurar eliminatorias» does, and writes nothing. After a group stage the places come from the groups: «Clasificación entre grupos» (POOL_RANK_PLACEMENT, the default: «1ro de 1ros», «2do de 1ros», …) or «Clasificación de grupos» (POOL_NUMBER_AND_RANK: «1ro Pool A», «2do Pool B», a group’s 1st and 2nd in opposite halves); the teams are seated later, by confirmDraw, once the groups end. A straight knockout seats the category’s accepted teams at once: seeds («cabezas de serie») first, then sign-up order. A draw holds 2 to 256 teams. Up to the next power of two the rest are byes, given to the best places. A third-place game is optional. Lists what the apply replaces. Answers a confirmationToken (15 minutes) to send unchanged to applyDraw once the organizer approved this exact draw. 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 knockout

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/draw/preview" \  -H "Content-Type: application/json" \  -d '{}'
{  "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": {    "afterGroups": true,    "method": "POOL_NUMBER_AND_RANK",    "numberOfTeams": 6,    "size": 8,    "byes": 2,    "thirdPlace": false,    "games": [      {        "number": 1,        "home": {          "teamNumber": 1,          "label": "1st Pool A",          "labelEs": "1ro Pool A",          "isBye": false,          "team": {            "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",            "name": "Lugo / Ramirez"          }        },        "away": {          "teamNumber": 1,          "label": "1st Pool A",          "labelEs": "1ro Pool A",          "isBye": false,          "team": {            "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",            "name": "Lugo / Ramirez"          }        }      }    ],    "replaced": {      "games": 0,      "draws": 0    }  },  "confirmationToken": "eyJ2IjoxLCJraW5kIjoicm91bmQuZHJhdyJ9.c2lnbmF0dXJl",  "expiresAt": "2027-03-14T15:15:00.000Z"}