Permissions

GET /tournaments/{tournament_id}/permissions

Authorized Access

Returns a collection of permissions from one 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 doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

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

    The permission identifier.

    Example: "378436939507009728"

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • attributes
    array[string]

    The list of permissions of the user in the tournament.

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

POST /tournaments/{tournament_id}/permissions

Authorized Access

Create permissions for a user 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 doesn't have any query parameters.

Request Body

Create a permission

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

    Email of the user.

    Example: "tournament.admin@team.com"

  • attributes
    array[string]

    The list of permissions of the user in the tournament.

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

Response

[201] Success

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

    The permission identifier.

    Example: "378436939507009728"

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • attributes
    array[string]

    The list of permissions of the user in the tournament.

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

GET /tournaments/{tournament_id}/permissions/{permission_id}

Authorized Access

Retrieves a permission of a tournament.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions/{permission_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.

  • permission_id
    string

    The identifier of the permission.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

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

    The permission identifier.

    Example: "378436939507009728"

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • attributes
    array[string]

    The list of permissions of the user in the tournament.

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

PATCH /tournaments/{tournament_id}/permissions/{permission_id}

Authorized Access

Updates the rights of a permission.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions/{permission_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.

  • permission_id
    string

    The identifier of the permission.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

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
{
    "id": "378436939507009728",
    "email": "tournament.admin@team.com",
    "attributes": [
        "report",
        "place",
        "register"
    ]
}
Structure (object)
  • id
    string

    The permission identifier.

    Example: "378436939507009728"

  • email
    string

    Email of the user.

    Example: "tournament.admin@team.com"

  • attributes
    array[string]

    The list of permissions of the user in the tournament.

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

DELETE /tournaments/{tournament_id}/permissions/{permission_id}

Authorized Access

Delete a user permissions in a tournament.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/permissions/{permission_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.

  • permission_id
    string

    The identifier of the permission.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[204] Success