OptionalplaylistIndex of the playlist to empty; 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.clear. Remove every track from a playlist, saving an undo point first. A locked playlist fails withLOCKEDbefore anything changes; tracks left behind afterwards fail withOPERATION_FAILED, the failure carrying the same fields as a success.