Opaque revision from the most recent configuration snapshot. Invalid after restart or provider replacement.
OptionalkeepNew keep-sorted setting; omitted keeps the current manager flag.
OptionalplaylistPlaylist index; required unless playlistGuid is given. No active-playlist default.
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.
OptionalqueryNew query, at most 65536 UTF-8 bytes. Blank text and NUL are rejected; omitted keeps the query.
OptionalsortNew independent sort; empty clears it, omitted keeps it. Conflicts with query SORT BY when nonempty. At most 65536 UTF-8 bytes, without NUL.
Parameters for
playlist.setAutoplaylistConfig. Edit configuration of a managed autoplaylist against its expected revision. Omitted fields keep existing values; provide at least one modification. Unchanged values do not advance revision or trigger rebuilds. Stale revisions fail withOPERATION_FAILED(details.reason: 'revisionConflict'). Configuration is validated before write. Host failures may leave changes partially applied:details.state(unchanged,changed, orunknown) covers the configuration only, anddetails.currentis included only when the current state is known. Neither success nor failure indicates disk persistence or finished track rebuilds.