Change Tournament State

PUT

/tournaments/{tournament_id}/change_state.json

Changes a tournament's state

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://api.challonge.com/oauth/authorize

Token URL: https://api.challonge.com/oauth/token

Path Params

Query Params

Header Params

Body Params application/vnd.api+jsonRequired

Examples

Responses

🟢200OK

application/json

Tournament Response

Body

🟠401Unauthorized

🟠404Not Found

🟠406Not Acceptable

🟠415Unsupported Media Type

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.challonge.com/v2.1/tournaments//change_state.json?community_id' \
--header 'Accept;' \
--header 'Authorization-Type;' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "type": "TournamentState",
        "attributes": {
            "state": "process_checkin"
        }
    }
}'

Response Example

200 - Example 1

{
    "id": "30201",
    "type": "tournament",
    "attributes": {
        "name": "Rainbow Six: Siege Tournament",
        "url": "r6siege_tournament_xx",
        "tournament_type": "single elimination",
        "game_name": "Tom Clancy's Rainbow Six Siege",
        "private": false,
        "starts_at": "string",
        "description": "string",
        "notifications": {
            "upon_matches_open": true,
            "upon_tournament_ends": true
        },
        "match_options": {
            "consolation_matches_target_rank": 3,
            "accept_attachments": false
        },
        "registration_options": {
            "open_signup": false,
            "signup_cap": 0,
            "check_in_duration": 0
        },
        "seeding_options": {
            "hide_seeds": false,
            "sequential_pairings": false
        },
        "station_options": {
            "auto_assign": false,
            "only_start_matches_with_assigned_stations": false
        },
        "group_stage_enabled": false,
        "group_stage_options": {
            "stage_type": "round robin",
            "group_size": 4,
            "participant_count_to_advance_per_group": 2,
            "rr_iterations": 1,
            "ranked_by": "",
            "rr_pts_for_match_win": 1,
            "rr_pts_for_match_tie": 0.5,
            "rr_pts_for_game_win": 0,
            "rr_pts_for_game_tie": 0,
            "split_participants": false
        },
        "double_elimination_options": {
            "split_participants": false,
            "grand_finals_modifier": ""
        },
        "round_robin_options": {
            "iterations": 2,
            "ranking": "",
            "pts_for_game_win": 1,
            "pts_for_game_tie": 0,
            "pts_for_match_win": 1,
            "pts_for_match_tie": 0.5
        },
        "swiss_options": {
            "rounds": 2,
            "pts_for_game_win": 1,
            "pts_for_game_tie": 0,
            "pts_for_match_win": 1,
            "pts_for_match_tie": 0.5
        },
        "free_for_all_options": {
            "max_participants": 4
        }
    }
}

Modified at 2025-11-04 17:45:58

Delete Tournament

List Participants