Playlist editor API

List a playlist's categories

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

Called with a playlist editor API token. How

The categories of one kind, in order; the ones in the bin too (deleted_at set).

Path parameters

  • kindstringrequired

    live (channels), movie (movies) or series (TV shows).

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

  • pidstring (uuid)required

Headers

  • X-Token-Passwordstring

    The token's own password, when it was made with one.

Response

200 OK

  • resultsobject[]required
    • idintegerrequired
    • namestringrequired
    • source_namestringrequired

      The provider's name for it.

    • positionintegerrequired
    • hiddenbooleanrequired
    • sync_namebooleanrequired
    • deleted_atstring (date-time)requiredcan be null

      Set while it is in the bin.

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