SETTO API

Seat the knockout’s first round from the final group standings («Confirmar cuadro») (needs the `manage` scope)

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

Seats the teams the final group standings name in the knockout’s first round, as «Confirmar cuadro» does, once the group stage is over (ROUND_ROBIN_INCOMPLETE lists what is missing); byes pass their team straight through. A first round already fully seated, by an earlier confirmation or by hand (its order may differ from the standings), changes nothing (changed: false, nothing written), the same body sent again included; one partly seated by hand is a 409 DRAW_ALREADY_CONFIRMED. A withdrawn team («Baja») is never seated: replace gives its slot to another team of the category or to a bye (the game then reads «BYE» and leaves the schedule; it has no loser, so a third-place game it fed becomes a bye for the other semifinal’s loser), and without an entry the confirmation is refused (DRAW_SEATS_WITHDRAWN_TEAM). Optional Idempotency-Key header. Recorded in «Actividad».

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Path Parameters

idx*string

Tournament identifier

Formatuuid
roundIdx*string

Round identifier: a knockout after a group stage

Formatuuid

Header 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.

Lengthlength <= 255

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/confirm" \  -H "Content-Type: application/json" \  -d '{}'
{  "round": {    "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90"  },  "changed": true,  "seated": [    {      "gameIdx": "d0e1f2a3-b4c5-4678-9d0e-1f2a3b4c5d6e",      "number": 1,      "home": {        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",        "name": "Lugo / Ramirez"      },      "away": {        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",        "name": "Lugo / Ramirez"      }    }  ],  "replaced": [    {      "teamIdx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",      "withTeam": {        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",        "name": "Lugo / Ramirez"      },      "gameIdx": "d0e1f2a3-b4c5-4678-9d0e-1f2a3b4c5d6e",      "side": "home"    }  ]}