changeStateTournament

Deprecated

PUT

/tournaments/{url}/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

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/tournaments//matches//change_state.json' \
--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": {
        "id": null,
        "state": null,
        "round": null,
        "identifier": null,
        "scores": null,
        "score_in_sets": null,
        "timestamps": null,
        "winner": null,
        "player1": null,
        "player2": null,
        "participants": null,
        "attachments": null
    }
}

Modified at 2025-11-05 16:03:26

updateMatch

findParticipants