API reference

The pages in this section are generated from the SETTO External API's OpenAPI document, so they cannot drift from the API: one page per operation, with its path, method, every parameter, the security scheme and the response schema. Each page also carries a Try it panel that fires a real request from your browser, so you can see a live payload without leaving the docs. If you are looking for worked examples and advice rather than an exhaustive parameter list, read the guides instead.

The operations

Pages are grouped by OpenAPI tag — Organization, Tournaments, Divisions, Teams, Rounds, Scheduling, Activity — which is also how the sidebar is ordered.

Using "Try it"

Every operation page has a panel where you can fill in the path and query parameters and send the request.

1. Open the Authorization field and paste a SETTO API token, personal or organization (setto_live_…). The panel uses the apiToken bearer scheme declared in the spec.
2. Fill in idx — a real tournament or round UUID that your token reaches.
3. Send. The response comes back with its status, headers and body.

If a request fails with a network or CORS error rather than an HTTP status, the token never left your browser — check the token and the URL and try again.

The raw OpenAPI document

The same document that generates these pages is published at /openapi.json. Point a client generator, a Postman import or an AI agent at it:

curl -s https://docs.setto.io/openapi.json -o setto-external-api.json

Its servers[0].url is filled in at request time from the API base URL this site is configured against, so the URLs in a generated client are correct without editing.

Related

• Authentication — before you paste a token anywhere.
• Errors — every status and code the reference lists.
• Rate limits — the headers on every response.