get_devices
Retrieve a list of Spotify-connected devices, including names, types, active status, and capabilities, to manage playback targeting, monitor availability, or integrate with smart home systems.
Instructions
Retrieve all available Spotify-connected devices for the user's account.
šÆ USE CASES: ā¢ Display device options for playback targeting ā¢ Build device management and control interfaces ā¢ Check which devices are currently online and available ā¢ Monitor device battery levels and connection status ā¢ Create smart home integrations with Spotify-enabled devices
š WHAT IT RETURNS: ā¢ Complete list of user's connected devices ā¢ Device names, types, and unique identifiers ā¢ Current active state and availability status ā¢ Volume levels and playback capabilities ā¢ Device restrictions and supported features
š EXAMPLES: ā¢ "Show me all my Spotify devices" ā¢ "What devices can I play music on?" ā¢ "List my available speakers and phones" ā¢ "Which devices are currently online?"
š§ DEVICE TYPES: ā¢ Computer (desktop/laptop applications) ā¢ Smartphone (mobile apps) ā¢ Speaker (smart speakers, soundbars) ā¢ TV (smart TVs, streaming devices) ā¢ Car (automotive systems) ā¢ Game Console (PlayStation, Xbox)
š” DEVICE MANAGEMENT: ā¢ Shows real-time availability status ā¢ Indicates which device is currently active ā¢ Displays volume control capabilities ā¢ Shows device-specific restrictions ā¢ Perfect for building device selector UIs
ā ļø REQUIREMENTS: ā¢ Valid Spotify access token with user-read-playback-state scope ā¢ At least one Spotify-enabled device must be logged in
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | Spotify access token for authentication |