Change Match State

PUT

/tournaments/{tournament_id}/matches/{match_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

Match 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//matches//change_state.json?community_id' \
--header 'Accept;' \
--header 'Authorization-Type;' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "type": "MatchState",
        "attributes": {
            "state": "reopen"
        }
    }
}'

Response Example

200 - Example 1

{
    "id": "8008135",
    "type": "match",
    "attributes": {
        "state": "complete",
        "round": 1,
        "identifier": "A",
        "suggested_play_order": 1,
        "scores": "2 - 0",
        "score_in_sets": [
            [
                3,
                1
            ],
            [
                4,
                2
            ]
        ],
        "points_by_participant": [
            {
                "participant_id": 355,
                "scores": [
                    3,
                    4
                ]
            },
            {
                "participant_id": 354,
                "scores": [
                    1,
                    2
                ]
            }
        ],
        "timestamps": {
            "created_at": "2023-04-21T14:29:06.374Z",
            "updated_at": "2023-04-21T14:31:45.981Z"
        },
        "winner_id": 355,
        "relationships": {
            "player1": {
                "data": {
                    "id": "355",
                    "type": "participant"
                }
            },
            "player2": {
                "data": {
                    "id": "354",
                    "type": "participant"
                }
            }
        }
    }
}

Modified at 2025-11-04 17:47:44

Update Match

List Match Attachments