SETTO API

Edit a category (needs the `manage` scope)

PATCH
/v1/external/tournaments/{idx}/divisions/{divisionIdx}

Changes only the keys sent (at least one): name, colour, modality (only while the category has no teams), team-format roster bounds, capacity («Cupo»), sign-ups open, visibility. The price is edited in the dashboard. Recorded in «Actividad».

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Path Parameters

idx*string

Tournament identifier

Formatuuid
divisionIdx*string

Category 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

application/json

curl -X PATCH "https://example.com/v1/external/tournaments/497f6eca-6276-4993-bfeb-53cbbbba6f08/divisions/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",  "name": "Primera Varonil",  "number": 1,  "color": "#1E3A8A",  "isDoubles": true,  "isVisible": true,  "price": 1200,  "minParticipants": null,  "maxParticipants": null,  "maxRegistrations": 32,  "createdAt": "2026-08-01T16:44:00.000Z",  "tournament": {    "idx": "f6a7b8c9-d0e1-4234-8f5a-6b7c8d9e0f1a"  },  "rounds": [    {      "idx": "a9b0c1d2-e3f4-4567-8a81-920314253647",      "name": "Pool Play",      "label": {        "es": "Fase de Grupos",        "en": "Group stage"      },      "type": "ROUND_ROBIN_ROUND",      "number": 1,      "isSetup": true,      "isVisible": true,      "gamesPerTeam": 3,      "gamesRequireWinners": true,      "numberOfSets": 3,      "proSets": false,      "playAllSets": false,      "pointsPerSet": 11,      "placements": [        1,        2      ],      "playEachTeamOnce": true,      "trueDoubleEliminationRound": null,      "numQualifiers": null,      "drawSize": null,      "hasNextRoundTransitioned": false,      "createdAt": "2026-08-20T10:55:00.000Z",      "division": {        "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",        "name": "Primera Varonil"      },      "pools": [        {          "idx": "d6e7f8a9-b0c1-4234-8d5e-6f7081920314",          "name": "Grupo A",          "number": 1,          "teams": [            {              "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",              "name": "Lugo / Ramirez"            }          ],          "standings": [            {              "idx": "c5d6e7f8-a9b0-4123-8c4d-5e6f70819203",              "rank": 1,              "awardedPoints": 250,              "team": {                "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                "name": "Lugo / Ramirez"              },              "teamStats": {                "idx": "b4c5d6e7-f8a9-4012-8b3c-4d5e6f708192",                "points": 9,                "wins": 3,                "losses": 1,                "ties": 0,                "cancelled": 0,                "forfeits": 0,                "pointsFor": 24,                "pointsAgainst": 15,                "setsPointsFor": 7,                "setsPointsAgainst": 3,                "totalGamesPlayed": 4,                "pointsDifference": 9,                "setsPointsDifference": 4              }            }          ]        }      ],      "games": [        {          "idx": "a3b4c5d6-e7f8-4901-8a2b-3c4d5e6f7081",          "number": 7,          "displayNumber": 7,          "status": "FINISHED",          "time": "2026-09-12T16:00:00.000Z",          "lengthInMinutes": 90,          "courtNumber": 2,          "matchDay": 1,          "roundDetail": "Grupo A",          "scheduleNumber": 14,          "sectionNumber": 1,          "isRetirement": false,          "isDoubleForfeit": false,          "retiredTeamId": null,          "liveStartedAt": null,          "resultApprovalStatus": "PENDING",          "submittedAt": null,          "homeTeamDetails": {            "label": "Winner of Game 3",            "labelEs": "Ganador del juego 3",            "teamNumber": 2,            "poolNumber": 1,            "poolRank": 1,            "sourceGameNumber": 3,            "sourceResult": "WINNER"          },          "awayTeamDetails": {            "label": "Winner of Game 3",            "labelEs": "Ganador del juego 3",            "teamNumber": 2,            "poolNumber": 1,            "poolRank": 1,            "sourceGameNumber": 3,            "sourceResult": "WINNER"          },          "createdAt": "2026-08-20T11:02:00.000Z",          "homeTeam": {            "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",            "name": "Lugo / Ramirez"          },          "awayTeam": {            "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",            "name": "Lugo / Ramirez"          },          "winner": {            "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",            "name": "Lugo / Ramirez"          },          "court": {            "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90",            "name": "Cancha 1",            "position": 1          },          "score": {            "idx": "f2a3b4c5-d6e7-4890-8f1a-2b3c4d5e6f70",            "home": 2,            "away": 1,            "playerPointsBalanced": null,            "extraTime": null,            "penalties": null,            "decisionMethod": "REGULATION",            "sets": [              {                "idx": "e1f2a3b4-c5d6-4789-8e0f-1a2b3c4d5e6f",                "home": 6,                "away": 4,                "number": 1,                "isTieBreak": false              }            ]          }        }      ],      "draws": [        {          "idx": "f8a9b0c1-d2e3-4456-8f70-819203142536",          "placement": 1,          "rounds": [            {              "idx": "e7f8a9b0-c1d2-4345-8e6f-708192031425",              "label": "Semifinal",              "order": 2,              "games": [                {                  "idx": "a3b4c5d6-e7f8-4901-8a2b-3c4d5e6f7081",                  "number": 7,                  "displayNumber": 7,                  "status": "FINISHED",                  "time": "2026-09-12T16:00:00.000Z",                  "lengthInMinutes": 90,                  "courtNumber": 2,                  "matchDay": 1,                  "roundDetail": "Grupo A",                  "scheduleNumber": 14,                  "sectionNumber": 1,                  "isRetirement": false,                  "isDoubleForfeit": false,                  "retiredTeamId": null,                  "liveStartedAt": null,                  "resultApprovalStatus": "PENDING",                  "submittedAt": null,                  "homeTeamDetails": {                    "label": "Winner of Game 3",                    "labelEs": "Ganador del juego 3",                    "teamNumber": 2,                    "poolNumber": 1,                    "poolRank": 1,                    "sourceGameNumber": 3,                    "sourceResult": "WINNER"                  },                  "awayTeamDetails": {                    "label": "Winner of Game 3",                    "labelEs": "Ganador del juego 3",                    "teamNumber": 2,                    "poolNumber": 1,                    "poolRank": 1,                    "sourceGameNumber": 3,                    "sourceResult": "WINNER"                  },                  "createdAt": "2026-08-20T11:02:00.000Z",                  "homeTeam": {                    "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                    "name": "Lugo / Ramirez"                  },                  "awayTeam": {                    "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                    "name": "Lugo / Ramirez"                  },                  "winner": {                    "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                    "name": "Lugo / Ramirez"                  },                  "court": {                    "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90",                    "name": "Cancha 1",                    "position": 1                  },                  "score": {                    "idx": "f2a3b4c5-d6e7-4890-8f1a-2b3c4d5e6f70",                    "home": 2,                    "away": 1,                    "playerPointsBalanced": null,                    "extraTime": null,                    "penalties": null,                    "decisionMethod": "REGULATION",                    "sets": [                      {                        "idx": "e1f2a3b4-c5d6-4789-8e0f-1a2b3c4d5e6f",                        "home": 6,                        "away": 4,                        "number": 1,                        "isTieBreak": false                      }                    ]                  }                }              ]            }          ]        }      ]    }  ],  "teams": [    {      "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",      "name": "Lugo / Ramirez",      "seed": 3,      "seedNumber": 1,      "club": "Club Deportivo Santa Fe",      "picture": "https://cdn.setto.io/teams/lugo-ramirez.png",      "description": "Campeones 2025",      "ranking": 12,      "isWildCard": false,      "qualifierStatus": "COMPETING",      "drawAssignment": "QUALIFYING",      "withdrawn": false,      "createdAt": "2026-08-01T17:30:00.000Z",      "division": {        "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",        "name": "Primera Varonil"      },      "players": [        {          "idx": "c9d0e1f2-a3b4-4567-8c8d-9e0f1a2b3c4d",          "firstName": "Mario",          "lastName": "Lugo",          "avatar": "https://cdn.setto.io/avatars/mario-lugo.png"        }      ],      "captainProfileIdx": "c9d0e1f2-a3b4-4567-8c8d-9e0f1a2b3c4d",      "leagueTeam": {        "idx": "d0e1f2a3-b4c5-4678-8d9e-0f1a2b3c4d5e",        "name": "Club Santa Fe",        "color": "#1E3A8A",        "logo": "https://cdn.setto.io/league-teams/santa-fe.png",        "position": 1,        "pointsAdjustment": 0      }    }  ],  "circuitCategory": {    "idx": "b2c3d4e5-f6a7-4890-8b1c-2d3e4f5a6b7c",    "name": "Primera Fuerza",    "gender": "MIXED",    "color": "#1E3A8A"  }}