Permissions

GET /tournaments/{tournament_id}/permissions

Authorized Access

Returns the complete list of permissions of a tournament.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:permission scope (see Authorization)

Path parameters

  • tournament_id
    string

    The identifier of the tournament.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[200] Success

Example
[
    {
        "attributes": [
            "report",
            "place",
            "register"
        ],
        "email": "tournament.admin@team.com",
        "id": "378436939507009728"
    }
]
Structure (collection)
  • attributes
    array[string]

    The list of permissions of the user in the tournament.

    Possible values: edit, delete, authorize, report, fill, place, register

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • id
    string

    The permission identifier.

    Example: "378436939507009728"

POST /tournaments/{tournament_id}/permissions

Authorized Access

Creates a new user permission in a tournament. You can not have more than 128 permissions in a tournament.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:permission scope (see Authorization)

Path parameters

  • tournament_id
    string

    The identifier of the tournament.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Permission data

Example
{
    "attributes": [
        "report",
        "place",
        "register"
    ],
    "email": "tournament.admin@team.com"
}
Structure (object)
  • attributes
    array[string]

    The list of permissions of the user in the tournament.

    Possible values: edit, delete, authorize, report, fill, place, register

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

Response

[201] Success

Example
{
    "attributes": [
        "report",
        "place",
        "register"
    ],
    "email": "tournament.admin@team.com",
    "id": "378436939507009728"
}
Structure (object)
  • attributes
    array[string]

    The list of permissions of the user in the tournament.

    Possible values: edit, delete, authorize, report, fill, place, register

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • id
    string

    The permission identifier.

    Example: "378436939507009728"

GET /tournaments/{tournament_id}/permissions/{id}

Authorized Access

Returns a single user permission of a tournament.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions/{id}

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:permission scope (see Authorization)

Path parameters

  • tournament_id
    string

    The identifier of the tournament.

  • id
    string

    The identifier of the permission.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[200] Success

Example
{
    "attributes": [
        "report",
        "place",
        "register"
    ],
    "email": "tournament.admin@team.com",
    "id": "378436939507009728"
}
Structure (object)
  • attributes
    array[string]

    The list of permissions of the user in the tournament.

    Possible values: edit, delete, authorize, report, fill, place, register

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • id
    string

    The permission identifier.

    Example: "378436939507009728"

PATCH /tournaments/{tournament_id}/permissions/{id}

Authorized Access

Updates the rights of a user permission.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions/{id}

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:permission scope (see Authorization)

Path parameters

  • tournament_id
    string

    The identifier of the tournament.

  • id
    string

    The identifier of the permission.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Permission data

Example
{
    "attributes": [
        "report",
        "place",
        "register"
    ]
}
Structure (object)
  • attributes
    array[string]

    The list of permissions of the user in the tournament.

    Possible values: edit, delete, authorize, report, fill, place, register

Response

[200] Success

Example
{
    "attributes": [
        "report",
        "place",
        "register"
    ],
    "email": "tournament.admin@team.com",
    "id": "378436939507009728"
}
Structure (object)
  • attributes
    array[string]

    The list of permissions of the user in the tournament.

    Possible values: edit, delete, authorize, report, fill, place, register

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • id
    string

    The permission identifier.

    Example: "378436939507009728"

DELETE /tournaments/{tournament_id}/permissions/{id}

Authorized Access

Deletes a user permissions from a tournament.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions/{id}

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:permission scope (see Authorization)

Path parameters

  • tournament_id
    string

    The identifier of the tournament.

  • id
    string

    The identifier of the permission.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[204] Success