Get a category
GET
/settings/categories/{id}/read Read: looks, changes nothing. Scopes
Shown or hidden. Any signed-in account may read it.
Path parameters
idstring (uuid)requiredA UUID string identifying this Category.
Response
200 OK
idstring (uuid)requiredread-onlyxtream_idintegerrequiredread-onlyThe number players know it by, in player links and the player API. Given when it is created, never changed or reused, because players save favourites against it.
namestringrequiredtypestringrequiredmovies- Moviestv_shows- TV Showsstreams- Streamscustom- Custom
One of:
"movies""tv_shows""streams""custom"descriptionstringcan be nullis_activebooleanorderintegerDisplay order within its type (lowest first).
streams_countintegerrequiredread-onlymovies_countintegerrequiredread-onlyseries_countintegerrequiredread-onlyprimary_countintegerrequiredread-onlycreated_atstring (date-time)requiredread-onlyupdated_atstring (date-time)requiredread-only
Errors
- 401 No credential, or one that is wrong, expired or revoked.
- 403 The account, or the key's or app's scopes, may not do this.
- 404 Nothing with this id, or nothing the account can see.
- 429 Slow down: wait the seconds in the Retry-After header, then try again.