Competier
  • api-key
  • ladder
  • ladder-entry
    • Adds a self-managed entry to a ladder.POST
    • Deletes a ladder-entry from a ladder, including all its ratings and results.DELETE
    • Gets ladder entries.GET
  • result
  • invite
  • account
  • credit
  • websocket
logoPowered by Apidog
  1. ladder-entry

Adds a self-managed entry to a ladder.

POST/v1/ladder-entry

Adds a self-managed entry to a ladder. Self-managed entries are not related to actual other Competier accounts - if you want your players to see and interact with your ladder in the Competier App, you need to send them an invite instead.

Request

Authorization: Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example
Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379
Body Params application/json
ladderId
integer 
required

id of the ladder that this ladder-entry belongs to.

Example:
0
name
string 
required

The display name for this ladder entry.

Example:
Jane Doe
rating
integer 
optional

Allows manually setting rating, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.

Example:
1500
reliabilityDeviation
integer 
optional

For Glicko algorithms: Allows manually setting relaibility deviation, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.

Example:
350
Example
{
  "ladderId": 0,
  "name": "Jane Doe",
  "rating": 1500,
  "reliabilityDeviation": 350
}

Request samples

Responses

OK(200)
Bad request(400)
Unauthorized(401)
Too Many Requests(429)
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
id
number 
read-onlyoptional

References a ladder-entry.

Example:
0
ladderId
integer 
required

id of the ladder that this ladder-entry belongs to.

Example:
0
name
string 
required

The display name for this ladder entry.

Example:
Jane Doe
rating
integer 
optional

Allows manually setting rating, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.

Example:
1500
reliabilityDeviation
integer 
optional

For Glicko algorithms: Allows manually setting relaibility deviation, for example when moving already existing ladders with ongoing ratings to Competier. Leave as default otherwise.

Example:
350
accountIds
array[integer]
read-onlyoptional

IDs of accounts represented by this entry. A ladder-entry representing real accounts will be generated in your ladder if those accounts accept invites to your ladder.

Example
Not configured
Last modified: 9 months ago