curl -X DELETE \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "User-Agent: my-app-name/1.0" \
"https://api.simkl.com/sync/playback/10916890?client_id=YOUR_CLIENT_ID&app-name=my-app-name&app-version=1.0"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}.
| 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). |
Use DELETE and pass a real positive integer id. Calling POST or GET /sync/playback/<id> does not delete anything — non-DELETE requests to this URL return the user’s paused-playback list instead, the same shape as GET /sync/playback. Always explicitly send DELETE, and pass an id you got from GET /sync/playback/{type}. DELETE /sync/playback/0, DELETE /sync/playback (no id), and DELETE /sync/playback/<non-numeric> all return 404 url_failed.
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).
curl -X DELETE \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "User-Agent: my-app-name/1.0" \
"https://api.simkl.com/sync/playback/10916890?client_id=YOUR_CLIENT_ID&app-name=my-app-name&app-version=1.0"Documentation Index
Fetch the complete documentation index at: https://api.simkl.org/llms.txt
Use this file to discover all available pages before exploring further.
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.
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).
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 >= 1Your 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.
Was this page helpful?