Remove from History
Removes items from the user’s watched history. Body shape is identical to POST /sync/history — the same movies[], shows[], and granularity rules apply.
Granularity
What you send determines what gets removed.
Movie or show with no seasons and no episodes — the item is removed from the user’s library entirely (any watch history AND the watchlist entry). Equivalent to the user clicking “Remove from list” on the title page.
Show with seasons[] entries that omit episodes — every episode in those seasons is unmarked as watched. The show stays in the user’s library.
Show with seasons[].episodes[] — only the listed episodes are unmarked. The show stays in the user’s library.
Show with top-level episodes[] shorthand — treated as seasons: [{ number: 1, episodes: [...] }]. Convenient for single-season shows; otherwise prefer the explicit form.
Item with a rewatch_id — removes from that rewatch session only; the original watch and the library entry are never touched. Without seasons, the whole session is deleted. With seasons[], only those episodes leave the session, and if none are left the session is deleted too.
Take the id from a GET /sync/all-items?allow_rewatch=yes row with is_rewatch: true, or from the response of the write that created the session. Removing a rewatch needs a Simkl PRO or VIP account, and the rewatch_id must belong to this user and this title — otherwise the item lands in not_found and nothing is removed. An item with is_rewatch: true but no rewatch_id lands in not_found too: it is never treated as a regular removal, so sending a rewatch row back can’t wipe the title.
Response shape
Status: 201 Created.
not_found.episodes lists episodes that don’t exist on a show Simkl did match: the show comes back with only those episode numbers in seasons. Episodes that exist but weren’t marked watched aren’t listed — they just don’t count toward deleted.episodes. If the show itself can’t be matched, it lands in not_found.shows and no episodes are touched.
Anime titles can go in shows[] or a top-level anime[] array, with anime IDs like mal / anidb / anilist inside ids — both are treated the same, and anime is counted and reported under shows. See Anime under shows[].
POST /sync/history
The mirror endpoint that adds history. Same body shape; this page is the removal side.
Sync guide — full walkthrough
Two-phase model (initial pull → activities-checked delta loop), deletion reconciliation, and reference implementations.
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.
A user access_token, sent as Authorization: Bearer .... Required for endpoints that read or modify the user's library, scrobble session, ratings, settings, or playbacks. Every flow returns the same kind of token. See Set up authentication.
Headers
Body
Body for /sync/history/remove — the same shape as /sync/history, plus an optional rewatch_id on an item to remove from that rewatch session only. Items go under movies[], shows[] or anime[].
Standard movie object. See the Standard Media Objects guide. Identify the title by ids, or — in a request — by title (with year to tell remakes apart).
- Option 1
- Option 2
Response
Counts of items affected, plus any IDs Simkl could not match.