Delete Playback
Removes a saved playback session by its id. HTTP method is DELETE — using POST or GET against this URL will not delete and will instead hit the list handler. Get the IDs from GET /sync/playback/{type}.
Possible responses
| Status | error | When |
|---|---|---|
204 | — | Session deleted. |
404 | empty | The id is numeric but does not match any playback session for this user. |
404 | url_failed | The id segment is missing, 0, or non-numeric (e.g. notanumber, abc123). |
Scrobble guide — full walkthrough
Real-time playback tracking — /start, /pause, /stop lifecycle, paused-playback resumption across devices, when scrobble auto-completes, and the difference between /scrobble/checkin (fire-and-forget) and /scrobble/start (active tracking).
Authorizations
Preferred form: your client_id as a URL query parameter on every request. Self-describing in logs and curl commands. See Headers and required parameters.
OAuth 2.0 or PIN-flow access_token. Required for endpoints that read or modify the user's library, scrobble session, ratings, settings, or playbacks. See Authentication.
Headers
Descriptive identifier for your app, ideally name/version. Examples: PlexMediaServer/1.43.1.10540, kodi-simkl/0.9.2, MyApp/2.4.1 (https://myapp.com).
Path Parameters
The numeric playback-session id to delete. Must be a positive integer — pass values returned in the id field of GET /sync/playback/{type}. Non-numeric ids return 404 url_failed; the literal value 0 is interpreted as "no id" and falls through to the list handler (see Warning above).
x >= 1Query Parameters
Your client_id from your Simkl developer settings. Required on every request.
Short, lowercase identifier for your app (e.g. plex-scrobbler, kodi-bridge). Helps Simkl identify which apps are using the API.
Your app's current version (e.g. 1.0, 2.4.1). Helps Simkl debug issues you report.