OptionalexpectedExpected content version for optimistic concurrency control. When mismatched, mutations are aborted with STALE_TARGET (details.current carries current version). Omitted, no check is made.
For each new row, the current row of the track that goes there; every row exactly once.
OptionalplaylistIndex of the playlist; omitted, the active playlist. An index past the last playlist fails with INVALID_INDEX; with this omitted and no active playlist the call fails with NO_ACTIVE_ITEM.
OptionalplaylistPersistent unique identifier of a playlist (bracketed GUID, case-insensitive), used in place of a mutable index. Mutually exclusive with playlist; passing both or an invalid format fails with INVALID_PARAMS. Fails with NOT_FOUND if the playlist does not exist, never falling back. Invalid-format and not-found failures return the given GUID in details.playlistGuid.
Parameters for
playlist.reorder. Reorder a playlist's tracks, saving an undo point first:newOrder[i]is the current row of the track that moves to rowi. A locked playlist fails withLOCKED, a list whose length is not the track count or that names a row twice withINVALID_PARAMS, an entry past the last row withINVALID_INDEX.