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.

Updates the playback progress for an existing item in the playback list. You must provide the mediaId and mediaType in the request body to identify the item, along with the new progress value (0-100) and optionally updatedAt.

Parameters

NameTypeRequiredDescription
mediaIdstringYesThe media ID with prefix (MV_TMDBID for movies, TV_TMDBID for TV shows)
progressnumberNoNew playback progress percentage (0-100)
updatedAtstring (date-time)NoISO 8601 timestamp for when playback was last updated
seasonintegerNoSeason number (only for TV shows)
episodeintegerNoEpisode number (only for TV shows)

Returns

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

Example

import { DiscovrClient } from "discovr";
import type { EditPlaybackPayload, 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.updatePlaybackItem("MV_TMDBID550", { progress: 75, updatedAt: "2023-01-15T00:00:00.000Z", season: 2, episode: 5 });
console.log(response);