Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.discovr.media/llms.txt

Use this file to discover all available pages before exploring further.

Removes a history item from the history list by its media ID. The item is identified by its media ID (DiscovrID with MV_ or TV_ prefix). TV Shows: For TV shows, season query parameter is required. episode is optional - when omitted, deletes the season default entry (entry without episode). When episode is provided, deletes entries matching that specific episode. Overriding Season Defaults: To unmark an episode that was completed via a season default entry, you have two options:
  1. Delete the season default entry (by omitting episode parameter) - this will affect all episodes in the season that were completed via the default.
  2. Create an explicit episode entry with progress < 80% using the addHistoryItem endpoint - this overrides the season default for that specific episode without affecting others.
Movies: For movies, no additional parameters are needed. Note: Since history allows duplicates, this operation will delete all matching history entries for the specified media (and episode, if applicable).

​
Parameters

NameTypeRequiredDescription
mediaIdstringYesThe DiscovrID (TV_<tmdbId> or MV_<tmdbId>) of the media item to delete
seasonintegerNoSeason number (required for TV shows only, must be provided when mediaId starts with TV_)
episodeintegerNoEpisode number (optional for TV shows, only valid when mediaId starts with TV_). When omitted, deletes the season default entry.

​
Returns

SuccessMessage — Item deleted successfully 
{
  "message": "string",
  "added": "string",
  "removed": "string"
}

​
Example

import { DiscovrClient } from "discovr";
import type { SuccessMessage } from "discovr";

const discovr = new DiscovrClient("your-client-id", {
  basePath: "https://api.discovr.media",
});

// After sign-in and profile selection …
const response: SuccessMessage = await discovr.deleteHistoryItem("TV_1396", { season: 1, episode: 5 });
console.log(response);