Playlist editor

Get a change

GET/editor/playlists/{pid}/history/{change_id}/

read Read: looks, changes nothing. Scopes

One change and what it did, row by row: each row's fields before (b) and after (a) it. Lists 2,000 rows at most; more counts the others.

Path parameters

  • change_idintegerrequired

    The change's id.

  • pidstring (uuid)required

    The playlist's id.

Response

200 OK

  • idintegerrequired
  • seqintegerrequired

    Its place in the playlist's history.

  • labelstringrequired

    What it did, in words, e.g. "Renamed 12 channels".

  • operationstringrequired

    The kind of edit, e.g. save, rename, move, delete, purge, sort, tool:replace, undo.

  • kindstringrequired

    The list it changed: live, movie or series; empty when it was not one list.

  • countintegerrequired

    How many rows it changed.

  • undoablebooleanrequired

    Whether it can still be undone or reverted.

  • undonebooleanrequired

    Whether it is undone (redo brings it back).

  • created_atstring (date-time)required
  • rowsobject[]required
    • tstringrequired

      What the row is: a channel, movie or TV show (entry), a category or an episode.

      • entry - entry
      • category - category
      • episode - episode
    • idintegerrequired
    • namestringrequired
    • banyrequiredcan be null

      The fields it changed, before; null: the change added the row.

    • aanyrequiredcan be null

      The same fields after; null: the change removed the row.

  • moreintegerrequired

    Rows of the change left out of rows.

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