Check out Challonge Connect, our new Tournament API Devkit for your Game, Website, or App.

Learn More ×

Update a participant


Update the attributes of a tournament participant.


PUT Help{tournament}/participants/{participant_id}.{json|xml}


Name Description
Your API key (required unless you're using HTTP basic authentication)
{tournament} (in URL string)
Tournament ID (e.g. 10230) or URL (e.g. 'single_elim' for If assigned to a subdomain, URL format must be :subdomain-:tournament_url (e.g. 'test-mytourney' for
{participant_id} (in URL string)
The participant's unique ID
participant[name] The name displayed in the bracket/schedule - not required if email or challonge_username is provided. Must be unique per tournament.
participant[challonge_username] Provide this if the participant has a Challonge account. He or she will be invited to the tournament.
participant[email] Providing this will first search for a matching Challonge account. If one is found, this will have the same effect as the "challonge_username" attribute. If one is not found, the "new-user-email" attribute will be set, and the user will be invited via email to create an account.
participant[seed] integer - The participant's new seed. Must be between 1 and the current number of participants (including the new record). Overwriting an existing seed will automatically bump other participants as you would expect.
participant[misc] string - Max: 255 characters. Multi-purpose field that is only visible via the API and handy for site integration (e.g. key to your users table)