Base URL
https://spotify.dev.cl0sed.net
One button. One request. One saved track.
Link Spotify once, then let your iPhone shortcut call this Worker whenever you want to favorite the track that is currently playing.
Configured and linked
Read-only mode
Favorite Endpoint
https://spotify.dev.cl0sed.net/api/favorite-current-track?format=text
Skip Endpoint
https://spotify.dev.cl0sed.net/api/skip-current-track?format=text
Debug Endpoint
https://spotify.dev.cl0sed.net/health
Diagnostics Endpoint
https://spotify.dev.cl0sed.net/diagnostics
Self-Check Endpoint
https://spotify.dev.cl0sed.net/self-check
Setup details and troubleshooting
Spotify app redirect URI: https://spotify.dev.cl0sed.net/auth/callback
Worker secrets: SPOTIFY_CLIENT_ID, SHORTCUT_SECRET, and optional ADMIN_SECRET. KV binding: STATE_STORE.
Favorite shortcut request: POST https://spotify.dev.cl0sed.net/api/favorite-current-track?format=text with the header x-action-secret.
Skip shortcut request: POST https://spotify.dev.cl0sed.net/api/skip-current-track?format=text with the header x-action-secret.
The link flow is intentionally hidden from read-only visitors. To manage Spotify linking and the live playback panel, open this page once with ?secret=...; the Worker stores admin access in a secure browser cookie and removes the secret from the URL.
If saving fails, the Worker includes the identified track in both the JSON response and plain-text error message when Spotify returned one.