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.

Adds a media item to the playback list for a specific profile. You can optionally provide an initial progress value (0-100) and updatedAt timestamp when adding the item. Note: If the item already exists in the playback list, the operation will return a success response without creating a duplicate.

​
Parameters

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

​
Returns

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

​
Example

import { DiscovrClient } from "discovr";
import type { AddPlaybackPayload, 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.addPlaybackItem("MV_TMDBID550", { progress: 25.5, updatedAt: "2023-01-15T00:00:00.000Z" });
console.log(response);