Playlist editor

List categories

GET/editor/playlists/{pid}/categories/{kind}/

read Read: looks, changes nothing. Scopes

The categories of one of the playlist's lists, in order, each with how many rows it shows, without the rows themselves.

Path parameters

  • kindstringrequired

    Which list of the playlist: live (channels), movie (movies) or series (TV shows).

    One of: "live" "movie" "series"

  • pidstring (uuid)required

    The playlist's id.

Query parameters

  • deletedboolean

    true to include what is in the recycle bin.

    Default: false

Response

200 OK

  • idintegerrequired
  • namestringrequired
  • source_namestringrequired

    Its name at the provider ('' for one made in the editor).

  • positionintegerrequired

    Categories are listed by position.

  • hiddenbooleanrequired

    Hidden from the playlist players get.

  • sync_namebooleanrequired

    Takes the provider's name again at each sync.

  • deleted_atstring (date-time)requiredcan be null

    When it went to the recycle bin; null when it is not there.

  • countintegerrequired

    How many rows it shows.

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.

What each error means