Skip to content

Create Rank

POST
/v1/sandbox/{sandbox_id}/rank

Create a new Rank in a sandbox

Requires permission sandbox:config:edit.

Authorizations

Parameters

Path Parameters

sandbox_id
required

Sandbox ID

string format: uuid

Sandbox ID

Request Body required

This mixin is meant to give a set of common properties to root config models

object
name

Name of the resource

string
>= 1 characters <= 125 characters
description

Description of the resource

string
>= 1 characters <= 250 characters
custom_data

Custom data associated with the resource

object
key
additional properties
string
max_mu
required

The maximum skill value that can be achieved in this Rank

number
min_mu
required

The minimum skill value that can be achieved in this Rank

number
min_sigma
required

The minimum sigma value achievable in this Rank when calculating with the ranking calculations.

number
>= 5
beta

Default beta value for ranking calculations, which represents the distance in rating to have ~76% chance of winning for the higher rated player. The default is 4.167

number
default_mu
required

Default mu value for ranking calculations, which represents player skill. The default is 25

number
default_sigma
required

Default sigma for ranking calculations, which represents the systems uncertainty on the player’s mu (higher values mean more uncertainty). The default is 8.333

number
>= 5
draw_probability

Draw probability for ranking calculations. The default is 0.1

number
tau

Tau represents the additive dynamic factor for ranking calculations. The higher the value, the more dynamic ratings will be (wins grant more, and losses lose more). The default value is 0.083

number
legacy_config

Old config used by Legacy systems. These values are ignored by the current APIs

object
rank_id

Old rank type id

integer

Responses

200

Successful Response

This mixin is meant to give a set of common properties to root config models

object
name

Name of the resource

string
>= 1 characters <= 125 characters
description

Description of the resource

string
>= 1 characters <= 250 characters
custom_data

Custom data associated with the resource

object
key
additional properties
string
max_mu
required

The maximum skill value that can be achieved in this Rank

number
min_mu
required

The minimum skill value that can be achieved in this Rank

number
min_sigma
required

The minimum sigma value achievable in this Rank when calculating with the ranking calculations.

number
>= 5
beta

Default beta value for ranking calculations, which represents the distance in rating to have ~76% chance of winning for the higher rated player. The default is 4.167

number
default_mu
required

Default mu value for ranking calculations, which represents player skill. The default is 25

number
default_sigma
required

Default sigma for ranking calculations, which represents the systems uncertainty on the player’s mu (higher values mean more uncertainty). The default is 8.333

number
>= 5
draw_probability

Draw probability for ranking calculations. The default is 0.1

number
tau

Tau represents the additive dynamic factor for ranking calculations. The higher the value, the more dynamic ratings will be (wins grant more, and losses lose more). The default value is 0.083

number
sandbox_id

ID of the Sandbox

string format: uuid
last_modified_account_id

Account ID of the user who last modified the resource

string format: uuid
last_modified_timestamp

Timestamp of when the resource was last modified

string format: date-time
created_timestamp

Timestamp of when this resource was created

string format: date-time
rank_id
required
string format: uuid

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string