Skip to main content
POST
remove_favorite

Authorizations

Authorization
string
header
default:YOUR_ACCESS_TOKEN
required

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

User-Agent
string
required

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).

Query Parameters

client_id
string
required

Your client_id from your Simkl developer settings. Required on every request.

app-name
string
required

Short, lowercase identifier for your app (e.g. plex-scrobbler, kodi-bridge). Helps Simkl identify which apps are using the API.

app-version
string
required

Your app's current version (e.g. 1.0, 2.4.1). Helps Simkl debug issues you report.

Body

application/json

Up to 1000 titles per request across the three arrays. A title of the wrong media type for the list is not added; it is reported in wrong_type. episodes and seasons buckets are refused — lists hold whole titles.

movies
object[]
shows
object[]
anime
object[]

Response

Done.

deleted
integer
required

Titles taken off the list.

not_found
object[]
required

Titles not on the list (a wrong media type included), echoed as you sent them.

lists
object
required

The favorite list of each media type the request touched. See Null and missing values.