Skip to main content
Version: v2.10.0

Interface: RestPlayOptions

Defines the payload for starting or controlling playback through Lavalink's REST endpoint.
Supports specifying the track (by encoded string or identifier), playback settings, filters, and voice connection parameters.


RestPlayOptions

Main structure containing playback options for a specific guild.

Property Type Description Optional
guildIdstringThe ID of the guild where playback is controlled.
dataRestPlayDataPlayback details and parameters.

RestPlayData

Playback details for a specific track and player state.

Property Type Description Optional
encodedTrackstringBase64-encoded track string. Alternative to identifier.
identifierstringTrack identifier (e.g. YouTube video ID). Alternative to encodedTrack.
startTimenumberPlayback start position in milliseconds.
endTimenumberPlayback end position in milliseconds.
volumenumberPlayback volume level (0–1000).
positionnumberCurrent playback position in milliseconds.
pausedbooleanWhether the player should be paused.
filtersobjectAudio filters to apply.
voiceLavalinkVoiceStateUpdateVoice connection payload sent to the Lavalink node.
noReplacebooleanIf true, prevents replacing the currently playing track when a new play payload is sent.