SETTO API
Referencia de la APIScheduling

Propose a «Un grupo por cancha» schedule for one day (writes nothing)

POST
/v1/external/tournaments/{idx}/schedule/proposals

Runs the dashboard’s «Un grupo por cancha» planner and returns its proposal; nothing is saved. Each group plays its games back to back on ONE court, in generated order, starts spaced by the longest game being placed (slotMinutes); parallel courts take other categories. Only unscheduled round-robin games of the chosen categories are placed; every game already on the grid stays where it is and is worked around. A CANNOT_PLAY petition is never broken; a PREFERS petition is tried first and reported in petitionMisses when it could not be met. A group that does not fit is left out whole and listed in unplaceable. Show the proposal to the organizer, then send placements unchanged to applySchedulePlacements. A court or category of another tournament is answered like an unknown one (COURT_NOT_FOUND, DIVISION_NOT_FOUND, with details).

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Path Parameters

idx*string

Tournament identifier

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

curl -X POST "https://example.com/v1/external/tournaments/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedule/proposals" \  -H "Content-Type: application/json" \  -d '{    "day": "2026-11-07",    "start": "09:00"  }'
{  "strategy": "POOL_PER_COURT",  "slotMinutes": 60,  "placements": [    {      "gameIdx": "d0e1f2a3-b4c5-4678-9d0e-1f2a3b4c5d6e",      "start": "2026-11-07T15:00:00.000Z",      "end": "2026-11-07T16:00:00.000Z",      "courtIdx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90",      "lengthInMinutes": 60    }  ],  "unplaceable": [    {      "gameIdx": "d0e1f2a3-b4c5-4678-9d0e-1f2a3b4c5d6e",      "reason": "OUT_OF_SLOTS"    }  ],  "petitionMisses": [    {      "gameIdx": "d0e1f2a3-b4c5-4678-9d0e-1f2a3b4c5d6e",      "teamIdx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",      "day": "2026-11-07",      "startTime": "10:00",      "endTime": "14:00"    }  ]}