Endpoints
- GET /tournaments/{tournament_id}/streams
Retrieve the list of streams of a tournament.
Authorized Access - POST /tournaments/{tournament_id}/streams
Add a new stream in a tournament.
Authorized Access - GET /tournaments/{tournament_id}/streams/{id}
Retrieve a single stream from a tournament.
Authorized Access - PATCH /tournaments/{tournament_id}/streams/{id}
Update a single stream in a tournament.
Authorized Access - DELETE /tournaments/{tournament_id}/streams/{id}
Delete a stream in a tournament.
Authorized Access - GET /tournaments/{tournament_id}/matches/{match_id}/streams
Retrieve the list of streams linked to a match.
Authorized Access - PUT /tournaments/{tournament_id}/matches/{match_id}/streams
Update the list of streams linked to a match.
Authorized Access
GET /tournaments/{tournament_id}/streams
Returns the list of streams of the given tournament.
Resource URL
https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/streams
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:admin
scope (see Authorization) - Rangestring
A range of requested items using the
streams
unit. The size of the range can not exceed 50. (see Pagination)Example: streams=0-49
Path parameters
- tournament_idstring
The id of the tournament you want to retrieve data about.
Query Parameters
This endpoint does not have any query parameters.
Request Body
This endpoint does not require a request body.
Response
[206] Streams retrieved.
Example
[ { "name": "Stream", "url": "https:\/\/www.twitch.tv\/stream", "language": "en", "id": "1146390604275957762" } ]
Structure (collection)
- namestring
The title of the stream.
Example: "Stream"
- urlstring
The URL of the stream.
Example: "https://www.twitch.tv/stream"
- languagestring
Language of the stream content, in ISO 639-1 alpha-2 format.
Example: "en"
- idstring
The id of the stream.
Example: "1146390604275957762"
POST /tournaments/{tournament_id}/streams
Create a new stream in a tournament. You can not have more than 128 streams in a tournament.
Resource URL
https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/streams
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:admin
scope (see Authorization)
Path parameters
- tournament_idstring
The id of the tournament you want to retrieve data about.
Query Parameters
This endpoint does not have any query parameters.
Request Body
Stream data
Example
{ "name": "Stream", "url": "https:\/\/www.twitch.tv\/stream", "language": "en" }
Structure (object)
- namestring
Optional
The title of the stream.
Example: "Stream"
- urlstring
Optional
The URL of the stream.
Example: "https://www.twitch.tv/stream"
- languagestring
Optional
Language of the stream content, in ISO 639-1 alpha-2 format.
Example: "en"
Response
[201] Success
Example
{ "name": "Stream", "url": "https:\/\/www.twitch.tv\/stream", "language": "en", "id": "1146390604275957762" }
Structure (object)
- namestring
The title of the stream.
Example: "Stream"
- urlstring
The URL of the stream.
Example: "https://www.twitch.tv/stream"
- languagestring
Language of the stream content, in ISO 639-1 alpha-2 format.
Example: "en"
- idstring
The id of the stream.
Example: "1146390604275957762"
GET /tournaments/{tournament_id}/streams/{id}
Returns a single stream from a tournament.
Resource URL
https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/streams/{id}
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:admin
scope (see Authorization)
Path parameters
- tournament_idstring
The id of the tournament you want to retrieve data about.
- idstring
The id of the stream.
Query Parameters
This endpoint does not have any query parameters.
Request Body
This endpoint does not require a request body.
Response
[200] Success
Example
{ "name": "Stream", "url": "https:\/\/www.twitch.tv\/stream", "language": "en", "id": "1146390604275957762" }
Structure (object)
- namestring
The title of the stream.
Example: "Stream"
- urlstring
The URL of the stream.
Example: "https://www.twitch.tv/stream"
- languagestring
Language of the stream content, in ISO 639-1 alpha-2 format.
Example: "en"
- idstring
The id of the stream.
Example: "1146390604275957762"
PATCH /tournaments/{tournament_id}/streams/{id}
Update a single stream in a tournament.
Resource URL
https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/streams/{id}
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:admin
scope (see Authorization)
Path parameters
- tournament_idstring
The id of the tournament you want to retrieve data about.
- idstring
The id of the stream.
Query Parameters
This endpoint does not have any query parameters.
Request Body
Stream data
Example
{ "name": "Stream", "url": "https:\/\/www.twitch.tv\/stream", "language": "en" }
Structure (object)
- namestring
Optional
The title of the stream.
Example: "Stream"
- urlstring
Optional
The URL of the stream.
Example: "https://www.twitch.tv/stream"
- languagestring
Optional
Language of the stream content, in ISO 639-1 alpha-2 format.
Example: "en"
Response
[200] Success
Example
{ "name": "Stream", "url": "https:\/\/www.twitch.tv\/stream", "language": "en", "id": "1146390604275957762" }
Structure (object)
- namestring
The title of the stream.
Example: "Stream"
- urlstring
The URL of the stream.
Example: "https://www.twitch.tv/stream"
- languagestring
Language of the stream content, in ISO 639-1 alpha-2 format.
Example: "en"
- idstring
The id of the stream.
Example: "1146390604275957762"
DELETE /tournaments/{tournament_id}/streams/{id}
Delete a stream in a tournament.
Resource URL
https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/streams/{id}
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:admin
scope (see Authorization)
Path parameters
- tournament_idstring
The id of the tournament you want to retrieve data about.
- idstring
The id of the stream.
Query Parameters
This endpoint does not have any query parameters.
Request Body
This endpoint does not require a request body.
Response
[204] Success
GET /tournaments/{tournament_id}/matches/{match_id}/streams
Returns the list of streams linked to a match. 32 streams maximum linked to a match.
Resource URL
https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/matches/{match_id}/streams
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:admin
scope (see Authorization)
Path parameters
- tournament_idstring
The id of the tournament you want to retrieve data about.
- match_idstring
The id of the match you want to retrieve data about.
Query Parameters
This endpoint does not have any query parameters.
Request Body
This endpoint does not require a request body.
Response
[200] Success
Example
[ "618951258745465416", "574431425878674446" ]
Structure (object)
- idarray[string]
The list of stream ids associated to this match.
Example: ["618951258745465416","574431425878674446"]
PUT /tournaments/{tournament_id}/matches/{match_id}/streams
Update the list of streams linked to a match. You can not have more than 32 streams in linked to a match.
Resource URL
https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/matches/{match_id}/streams
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:admin
scope (see Authorization)
Path parameters
- tournament_idstring
The id of the tournament you want to retrieve data about.
- match_idstring
The id of the match you want to retrieve data about.
Query Parameters
This endpoint does not have any query parameters.
Request Body
Stream data
Example
[ "618951258745465416", "574431425878674446" ]
Structure (object)
- idarray[string]
The list of stream ids associated to this match.
Example: ["618951258745465416","574431425878674446"]
Response
[200] Success
Example
[ "618951258745465416", "574431425878674446" ]
Structure (object)
- idarray[string]
The list of stream ids associated to this match.
Example: ["618951258745465416","574431425878674446"]