Circuit API › Tiers

GET /tiers

Retrieves the tiers of all your circuits.

Resource URL

https://api.toornament.com/circuit/v2/tiers

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:circuit scope (see Authorization)

  • Range
    string

    A range of requested items using the tiers unit. The size of the range can not exceed 50. (see Pagination)

    Example: tiers=0-49

Query Parameters

  • circuit_ids
    array

    Only return circuits for the given list of ids.

    Example: 5617559294676615168,5629045554450325504

Request Body

This endpoint does not require a request body.

Response

[206] Tiers retrieved.

Example
[
    {
        "name": "Tier 1",
        "order": 0,
        "machine_name": "tier1",
        "id": "5629088936350867456"
    }
]
Structure (collection)
  • name
    string

    The name of the tier.

    Max. length: 40 characters

    Example: "Tier 1"

  • order
    integer

    Number used to determine the order in which the tiers are displayed.

    Example: 0

  • machine_name
    string

    A name used to identify a tier for computing purposes.

    Pattern: ^[a-z0-9_]+$

    Max. length: 40 characters

    Example: "tier1"

  • id
    string

    The unique identifier of the tier.

    Example: "5629088936350867456"

POST /tiers

Creates a new tier.

Resource URL

https://api.toornament.com/circuit/v2/tiers

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:circuit scope (see Authorization)

Query Parameters

This endpoint does not have any query parameters.

Request Body

Tier data

Example
{
    "name": "Tier 1",
    "order": 0,
    "machine_name": "tier1"
}
Structure (object)
  • name
    string

    The name of the tier.

    Max. length: 40 characters

    Example: "Tier 1"

  • order
    integer

    Optional

    Number used to determine the order in which the tiers are displayed.

    Example: 0

  • machine_name
    string

    A name used to identify a tier for computing purposes.

    Pattern: ^[a-z0-9_]+$

    Max. length: 40 characters

    Example: "tier1"

Response

[201] Circuit created.

Example
{
    "name": "Tier 1",
    "order": 0,
    "machine_name": "tier1",
    "id": "5629088936350867456"
}
Structure (object)
  • name
    string

    The name of the tier.

    Max. length: 40 characters

    Example: "Tier 1"

  • order
    integer

    Number used to determine the order in which the tiers are displayed.

    Example: 0

  • machine_name
    string

    A name used to identify a tier for computing purposes.

    Pattern: ^[a-z0-9_]+$

    Max. length: 40 characters

    Example: "tier1"

  • id
    string

    The unique identifier of the tier.

    Example: "5629088936350867456"

GET /tiers/{id}

Retrieves a tier identified by the given id.

Resource URL

https://api.toornament.com/circuit/v2/tiers/{id}

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:circuit scope (see Authorization)

Path parameters

  • id
    string

    The id of the tier.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[200] Tier retrieved

Example
{
    "name": "Tier 1",
    "order": 0,
    "machine_name": "tier1",
    "id": "5629088936350867456"
}
Structure (object)
  • name
    string

    The name of the tier.

    Max. length: 40 characters

    Example: "Tier 1"

  • order
    integer

    Number used to determine the order in which the tiers are displayed.

    Example: 0

  • machine_name
    string

    A name used to identify a tier for computing purposes.

    Pattern: ^[a-z0-9_]+$

    Max. length: 40 characters

    Example: "tier1"

  • id
    string

    The unique identifier of the tier.

    Example: "5629088936350867456"

PATCH /tiers/{id}

Updates a tier identified by the given id.

Resource URL

https://api.toornament.com/circuit/v2/tiers/{id}

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:circuit scope (see Authorization)

Path parameters

  • id
    string

    The id of the tier.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Tier data.

Example
{
    "name": "Tier 1",
    "order": 0
}
Structure (object)
  • name
    string

    Optional

    The name of the tier.

    Max. length: 40 characters

    Example: "Tier 1"

  • order
    integer

    Optional

    Number used to determine the order in which the tiers are displayed.

    Example: 0

Response

[200] Tier update.

Example
{
    "name": "Tier 1",
    "order": 0,
    "machine_name": "tier1",
    "id": "5629088936350867456"
}
Structure (object)
  • name
    string

    The name of the tier.

    Max. length: 40 characters

    Example: "Tier 1"

  • order
    integer

    Number used to determine the order in which the tiers are displayed.

    Example: 0

  • machine_name
    string

    A name used to identify a tier for computing purposes.

    Pattern: ^[a-z0-9_]+$

    Max. length: 40 characters

    Example: "tier1"

  • id
    string

    The unique identifier of the tier.

    Example: "5629088936350867456"

DELETE /tiers/{id}

Deletes a tier identified by the given id.

Resource URL

https://api.toornament.com/circuit/v2/tiers/{id}

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:circuit scope (see Authorization)

Path parameters

  • id
    string

    The id of the tier.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[204] Success