Beta, PRO and VIP. Needs an AUTH V2 token with the media:writescope, belonging to a Simkl PRO or VIP account. A free account gets 403 premium_only here — a real error, unlike the 200 upgrade card that GET /lists/{id} returns. Full walkthrough: Edit a custom list.
Takes titles off the caller’s favorite lists, each from the list of its own media type. Always 200.
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).
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[]
Hide child attributes
movies.ids
object
Any ID Simkl knows: simkl (or simkl_id, as GET /lists/{id} returns it), tmdb, imdb, tvdb, mal, anidb, anilist, kitsu, and the rest of the supported IDs. 0 and "" count as missing.
Hide child attributes
movies.ids.simkl
integer
Example:
53992
movies.ids.simkl_id
integer
movies.ids.tmdb
stringinteger
movies.ids.imdb
string
movies.ids.{key}
stringinteger
movies.title
string
movies.year
integer
movies.user_position
integer
Put the title at this place in the list's own order, 1-based — the number GET /lists/{id} returns as user_position. Past the end means the end; the titles after it shift down.
Required range: x >= 1
movies.season
integer
Anime only. Add the entry that covers this season instead of the base title. 0 means no hint. Ignored for TV and movies.
Required range: x >= 0
movies.seasons
object[]
Anime only. Several seasons at once; each becomes its own entry, in season order.
Maximum array length: 100
Hide child attributes
movies.seasons.number
integer
Required range: x >= 0
movies.note
object
Notes on this title. Trimmed, HTML removed, up to 4096 characters each. A note equal to the stored one is no change.
Hide child attributes
movies.note.public
string
Shown to everyone who can see the list.
movies.note.private
string
Returned by GET /lists/{id} only to the owner and to collaborators with a notes permission.
shows
object[]
Hide child attributes
shows.ids
object
Any ID Simkl knows: simkl (or simkl_id, as GET /lists/{id} returns it), tmdb, imdb, tvdb, mal, anidb, anilist, kitsu, and the rest of the supported IDs. 0 and "" count as missing.
Hide child attributes
shows.ids.simkl
integer
Example:
53992
shows.ids.simkl_id
integer
shows.ids.tmdb
stringinteger
shows.ids.imdb
string
shows.ids.{key}
stringinteger
shows.title
string
shows.year
integer
shows.user_position
integer
Put the title at this place in the list's own order, 1-based — the number GET /lists/{id} returns as user_position. Past the end means the end; the titles after it shift down.
Required range: x >= 1
shows.season
integer
Anime only. Add the entry that covers this season instead of the base title. 0 means no hint. Ignored for TV and movies.
Required range: x >= 0
shows.seasons
object[]
Anime only. Several seasons at once; each becomes its own entry, in season order.
Maximum array length: 100
Hide child attributes
shows.seasons.number
integer
Required range: x >= 0
shows.note
object
Notes on this title. Trimmed, HTML removed, up to 4096 characters each. A note equal to the stored one is no change.
Hide child attributes
shows.note.public
string
Shown to everyone who can see the list.
shows.note.private
string
Returned by GET /lists/{id} only to the owner and to collaborators with a notes permission.
anime
object[]
Hide child attributes
anime.ids
object
Any ID Simkl knows: simkl (or simkl_id, as GET /lists/{id} returns it), tmdb, imdb, tvdb, mal, anidb, anilist, kitsu, and the rest of the supported IDs. 0 and "" count as missing.
Hide child attributes
anime.ids.simkl
integer
Example:
53992
anime.ids.simkl_id
integer
anime.ids.tmdb
stringinteger
anime.ids.imdb
string
anime.ids.{key}
stringinteger
anime.title
string
anime.year
integer
anime.user_position
integer
Put the title at this place in the list's own order, 1-based — the number GET /lists/{id} returns as user_position. Past the end means the end; the titles after it shift down.
Required range: x >= 1
anime.season
integer
Anime only. Add the entry that covers this season instead of the base title. 0 means no hint. Ignored for TV and movies.
Required range: x >= 0
anime.seasons
object[]
Anime only. Several seasons at once; each becomes its own entry, in season order.
Maximum array length: 100
Hide child attributes
anime.seasons.number
integer
Required range: x >= 0
anime.note
object
Notes on this title. Trimmed, HTML removed, up to 4096 characters each. A note equal to the stored one is no change.
Hide child attributes
anime.note.public
string
Shown to everyone who can see the list.
anime.note.private
string
Returned by GET /lists/{id} only to the owner and to collaborators with a notes permission.
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.
Type 4 null — the request had no movies title for that list.
Hide child attributes
lists.movies.id
integer
required
lists.movies.counts
object
required
Totals for the whole list, independent of the page you requested. items is the list's real size -- compare it with pagination.total_items, which reflects the current query.
Hide child attributes
lists.movies.counts.items
integer
required
Titles in the list.
Example:
222
lists.movies.counts.likes
integer
required
Likes the list has received.
Example:
95
lists.movies.counts.followers
integer
required
Users following the list.
Example:
104
lists.movies.counts.comments
integer
required
Comments on the list.
Example:
0
lists.movies.counts.collaborators
integer
required
Users who can edit the list besides the owner.
Example:
1
lists.movies.updated_at
string<date-time>
required
UTC. Unchanged when the request changed nothing.
lists.tv
object | null
required
Type 4 null — the request had no tv title for that list.
Hide child attributes
lists.tv.id
integer
required
lists.tv.counts
object
required
Totals for the whole list, independent of the page you requested. items is the list's real size -- compare it with pagination.total_items, which reflects the current query.
Hide child attributes
lists.tv.counts.items
integer
required
Titles in the list.
Example:
222
lists.tv.counts.likes
integer
required
Likes the list has received.
Example:
95
lists.tv.counts.followers
integer
required
Users following the list.
Example:
104
lists.tv.counts.comments
integer
required
Comments on the list.
Example:
0
lists.tv.counts.collaborators
integer
required
Users who can edit the list besides the owner.
Example:
1
lists.tv.updated_at
string<date-time>
required
UTC. Unchanged when the request changed nothing.
lists.anime
object | null
required
Type 4 null — the request had no anime title for that list.
Hide child attributes
lists.anime.id
integer
required
lists.anime.counts
object
required
Totals for the whole list, independent of the page you requested. items is the list's real size -- compare it with pagination.total_items, which reflects the current query.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Simkl API","description":"Build apps that track Movies, TV Shows, and Anime — scrobble playback, sync watch history, and pull rich metadata from the Simkl API.","colors":{"primary":"#3B82F6","light":"#7DAEFF","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/andrewmasyk/yVND0Vg0vHbm_kqK/logo/light.svg?fit=max\u0026auto=format\u0026n=yVND0Vg0vHbm_kqK\u0026q=85\u0026s=3ed4c7fdfb9f19455db11c9a13dd466e","dark":"https://mintcdn.com/andrewmasyk/yVND0Vg0vHbm_kqK/logo/dark.svg?fit=max\u0026auto=format\u0026n=yVND0Vg0vHbm_kqK\u0026q=85\u0026s=01045ebbe2fa107aed1f989ec1622647","href":"https://api.simkl.org"},"favicon":"https://mintcdn.com/andrewmasyk/RbJc6mqlYX6FcPwH/favicon.svg?fit=max\u0026auto=format\u0026n=RbJc6mqlYX6FcPwH\u0026q=85\u0026s=d5bd6b8d56f55059c6307fb1e0db9fb7","api":{"openapi":"openapi.json","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","typescript","kotlin","swift","java","node","go","csharp","dotnet","php","ruby","powershell","c++","c"],"prefill":true,"autogenerate":true}},"appearance":{"default":"dark","strict":false},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://support.simkl.com","label":"Support"},{"href":"https://discord.gg/MJsWNE4","label":"Discord"}],"primary":{"type":"button","label":"Get an API key","href":"https://simkl.com/settings/developer/"}},"footer":{"socials":{"x":"https://twitter.com/Simkl","discord":"https://discord.gg/MJsWNE4"},"links":[{"header":"Resources","items":[{"label":"Quickstart","href":"/quickstart"},{"label":"API Reference","href":"/api-reference/introduction"},{"label":"Standard objects","href":"/conventions/standard-media-objects"},{"label":"Rate limits","href":"/resources/rate-limits"},{"label":"API rules","href":"/api-rules"},{"label":"OpenAPI 3.1 spec","href":"/openapi.json"}]},{"header":"Simkl","items":[{"label":"Simkl.com","href":"https://simkl.com"},{"label":"Get an API key","href":"https://simkl.com/settings/developer"},{"label":"Status","href":"https://status.simkl.com/"},{"label":"Terms","href":"https://simkl.com/about/policies/terms"}]},{"header":"Community","items":[{"label":"Discord","href":"https://discord.gg/MJsWNE4"},{"label":"X","href":"https://twitter.com/Simkl"}]}]},"seo":{"metatags":{"og:image":"https://i.simkl.com/img_tv/apiary_logo_api.png","og:site_name":"Simkl API"},"indexing":"all"},"fonts":{"family":"Open Sans"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"vesper"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","grok","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark"},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"andrewmasyk","hasAudioNarration":false,"actualSubdomain":"andrewmasyk","customDomains":["api.simkl.org"],"gitSource":{"type":"github","owner":"simkl","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afa16e82e6041f078dab076","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":91},{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"Auth","count":21},{"language":"default","tag":"AUTH V2","count":11},{"language":"default","tag":"Custom Lists","count":10},{"language":"default","tag":"Sync","count":10},{"language":"default","tag":"AUTH V1","count":9},{"language":"default","tag":"Conventions","count":8},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Browse \u0026 discover","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/andrewmasyk/10e184c8f2642821/style.css"}]}
{"page":{"pagePath":"api-reference/simkl/remove-favorites","slug":"/api-reference/simkl/remove-favorites","pageMetadata":{"title":"Remove favorites","description":"**Beta, PRO and VIP.** Needs an [AUTH V2](/api-reference/auth-v2) token with the `media:write` [scope](/api-reference/oauth2-scopes), belonging to a Simkl **PRO or VIP** account. A free account gets `403 premium_only` here — a real error, unlike the `200` upgrade card that `GET /lists/{id}` returns. Full walkthrough: [Edit a custom list](/guides/custom-lists#edit-a-custom-list).\n\nTakes titles off the caller's favorite lists, each from the list of its own media type. Always `200`.","deprecated":null,"version":null,"sidebarTitle":"Remove favorites","openapi":"/openapi.json post /lists/favorites/remove","href":"/api-reference/simkl/remove-favorites","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Beta, PRO and VIP.\"\n }), \" Needs an \", _jsx(_components.a, {\n href: \"/api-reference/auth-v2\",\n children: \"AUTH V2\"\n }), \" token with the \", _jsx(_components.code, {\n children: \"media:write\"\n }), \" \", _jsx(_components.a, {\n href: \"/api-reference/oauth2-scopes\",\n children: \"scope\"\n }), \", belonging to a Simkl \", _jsx(_components.strong, {\n children: \"PRO or VIP\"\n }), \" account. A free account gets \", _jsx(_components.code, {\n children: \"403 premium_only\"\n }), \" here — a real error, unlike the \", _jsx(_components.code, {\n children: \"200\"\n }), \" upgrade card that \", _jsx(_components.code, {\n children: \"GET /lists/{id}\"\n }), \" returns. Full walkthrough: \", _jsx(_components.a, {\n href: \"/guides/custom-lists#edit-a-custom-list\",\n children: \"Edit a custom list\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Takes titles off the caller’s favorite lists, each from the list of its own media type. Always \", _jsx(_components.code, {\n children: \"200\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"vesper"}},"config":{},"pageMetadata":{"title":"Remove favorites","description":"**Beta, PRO and VIP.** Needs an [AUTH V2](/api-reference/auth-v2) token with the `media:write` [scope](/api-reference/oauth2-scopes), belonging to a Simkl **PRO or VIP** account. A free account gets `403 premium_only` here — a real error, unlike the `200` upgrade card that `GET /lists/{id}` returns. Full walkthrough: [Edit a custom list](/guides/custom-lists#edit-a-custom-list).\n\nTakes titles off the caller's favorite lists, each from the list of its own media type. Always `200`.","deprecated":null,"version":null,"sidebarTitle":"Remove favorites","openapi":"/openapi.json post /lists/favorites/remove","href":"/api-reference/simkl/remove-favorites","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/andrewmasyk/c998d3ea10630993/scripts.js"],"openApiReferenceData":{"operation":{"operationId":"remove-favorites","summary":"Remove favorites","tags":["Lists"],"security":["61ccd36d-aa91-4440-b325-dfc3f32f0588"],"x-mint":{"href":"/api-reference/simkl/remove-favorites","metadata":{"sidebarTitle":"Remove favorites"}},"description":"**Beta, PRO and VIP.** Needs an [AUTH V2](/api-reference/auth-v2) token with the `media:write` [scope](/api-reference/oauth2-scopes), belonging to a Simkl **PRO or VIP** account. A free account gets `403 premium_only` here — a real error, unlike the `200` upgrade card that `GET /lists/{id}` returns. Full walkthrough: [Edit a custom list](/guides/custom-lists#edit-a-custom-list).\n\nTakes titles off the caller's favorite lists, each from the list of its own media type. Always `200`.","parameters":["2599f856-71a4-48a6-bccf-1f21dbb51082","0c73defd-e652-4927-948c-c9f87683e609","efa65e82-60e3-4f0c-9796-a03bc07fab8b","431f1839-878f-4201-9732-9dd2576b562d"],"requestBody":"18bda4a1-3c62-4323-aecc-676322b35c53","responses":{"200":"b95b7b1f-8ade-4697-a6be-d737df77e426","400":"40abd27f-791a-47c6-8d42-420112b3d4fa","401":"4a02643c-1ac8-48bb-a5d2-a7a5924a1be3","403":"08e85dfb-364d-4ff0-8072-5657b4a36d00","404":"f6dab985-224c-42af-b899-fea940f8f5f9","405":"80f67a0f-0010-4936-b002-273a25eec73b","429":"54429eca-2ef0-48bb-8f74-c1adffae40bc"},"x-codeSamples":[{"lang":"curl","label":"remove_favorite","source":"curl -X POST 'https://api.simkl.com/lists/favorites/remove?client_id=YOUR_CLIENT_ID\u0026app-name=my-app-name\u0026app-version=1.0' \\\n -H 'User-Agent: my-app-name/1.0' \\\n -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"movies\": [\n {\n \"ids\": {\n \"simkl\": 53992\n }\n }\n ]\n}'"}],"method":"post","type":"path","servers":["1ff7513b-7c65-431d-a68f-d379fa335309","23b65516-5008-4875-b78d-4bd0b879e4f4"],"path":"/lists/favorites/remove","baseUrlOptions":["https://api.simkl.com","https://data.simkl.in"],"title":"Remove favorites","codeSamples":[{"label":"remove_favorite","lang":"curl","source":"curl -X POST 'https://api.simkl.com/lists/favorites/remove?client_id=YOUR_CLIENT_ID\u0026app-name=my-app-name\u0026app-version=1.0' \\\n -H 'User-Agent: my-app-name/1.0' \\\n -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"movies\": [\n {\n \"ids\": {\n \"simkl\": 53992\n }\n }\n ]\n}'"}],"requestExampleLanguages":["bash","python","javascript","typescript","kotlin","swift","java","node","go","csharp","dotnet","php","ruby","powershell","c++","c"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.movies.items.0.ids.simkl":53992}]},"dependencies":{"parameters":{"2599f856-71a4-48a6-bccf-1f21dbb51082":{"name":"client_id","in":"query","required":true,"description":"Your **`client_id`** from your [Simkl developer settings](https://simkl.com/settings/developer/). Required on every request.","schema":{"type":"string","isRequired":true,"description":"Your **`client_id`** from your [Simkl developer settings](https://simkl.com/settings/developer/). Required on every request.","uniqueKey":"","typeLabel":"string"},"example":"YOUR_CLIENT_ID"},"0c73defd-e652-4927-948c-c9f87683e609":{"name":"app-name","in":"query","required":true,"description":"Short, lowercase identifier for your app (e.g. `plex-scrobbler`, `kodi-bridge`). Helps Simkl identify which apps are using the API.","schema":{"type":"string","isRequired":true,"description":"Short, lowercase identifier for your app (e.g. `plex-scrobbler`, `kodi-bridge`). Helps Simkl identify which apps are using the API.","uniqueKey":"","typeLabel":"string"},"example":"my-app"},"efa65e82-60e3-4f0c-9796-a03bc07fab8b":{"name":"app-version","in":"query","required":true,"description":"Your app's current version (e.g. `1.0`, `2.4.1`). Helps Simkl debug issues you report.","schema":{"type":"string","isRequired":true,"description":"Your app's current version (e.g. `1.0`, `2.4.1`). Helps Simkl debug issues you report.","uniqueKey":"","typeLabel":"string"},"example":"1.0"},"431f1839-878f-4201-9732-9dd2576b562d":{"name":"User-Agent","in":"header","required":true,"description":"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)`.","schema":{"type":"string","isRequired":true,"description":"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)`.","uniqueKey":"","typeLabel":"string"},"example":"my-app/1.0"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"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.","properties":{"movies":{"type":"array","items":{"type":"object","description":"One title, in the same shape `POST /sync/history` takes. Needs `ids`, or a `title` (with `year` to disambiguate).","properties":{"ids":{"type":"object","description":"Any ID Simkl knows: `simkl` (or `simkl_id`, as `GET /lists/{id}` returns it), `tmdb`, `imdb`, `tvdb`, `mal`, `anidb`, `anilist`, `kitsu`, and the rest of the [supported IDs](/conventions/standard-media-objects). `0` and `\"\"` count as missing.","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"movies.items.[INDEX].ids.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"movies.items.[INDEX].ids.additionalProperties.oneOf.1","typeLabel":"integer"}],"uniqueKey":"movies.items.[INDEX].ids.additionalProperties","typeLabel":"string | integer"},"properties":{"simkl":{"type":"integer","example":53992,"uniqueKey":"movies.items.[INDEX].ids.simkl","typeLabel":"integer"},"simkl_id":{"type":"integer","uniqueKey":"movies.items.[INDEX].ids.simkl_id","typeLabel":"integer"},"tmdb":{"oneOf":[{"type":"string","uniqueKey":"movies.items.[INDEX].ids.tmdb.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"movies.items.[INDEX].ids.tmdb.oneOf.1","typeLabel":"integer"}],"uniqueKey":"movies.items.[INDEX].ids.tmdb","typeLabel":"string | integer"},"imdb":{"type":"string","uniqueKey":"movies.items.[INDEX].ids.imdb","typeLabel":"string"}},"uniqueKey":"movies.items.[INDEX].ids","typeLabel":"object"},"title":{"type":"string","uniqueKey":"movies.items.[INDEX].title","typeLabel":"string"},"year":{"type":"integer","uniqueKey":"movies.items.[INDEX].year","typeLabel":"integer"},"user_position":{"type":"integer","minimum":1,"description":"Put the title at this place in the list's own order, 1-based — the number `GET /lists/{id}` returns as `user_position`. Past the end means the end; the titles after it shift down.","uniqueKey":"movies.items.[INDEX].user_position","typeLabel":"integer"},"season":{"type":"integer","minimum":0,"description":"**Anime only.** Add the entry that covers this season instead of the base title. `0` means no hint. Ignored for TV and movies.","uniqueKey":"movies.items.[INDEX].season","typeLabel":"integer"},"seasons":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"number":{"type":"integer","minimum":0,"uniqueKey":"movies.items.[INDEX].seasons.items.[INDEX].number","typeLabel":"integer"}},"uniqueKey":"movies.items.[INDEX].seasons.items.[INDEX]","typeLabel":"object"},"description":"**Anime only.** Several seasons at once; each becomes its own entry, in season order.","uniqueKey":"movies.items.[INDEX].seasons","typeLabel":"object[]"},"note":{"type":"object","description":"Notes on this title. Trimmed, HTML removed, up to 4096 characters each. A note equal to the stored one is no change.","properties":{"public":{"type":"string","description":"Shown to everyone who can see the list.","uniqueKey":"movies.items.[INDEX].note.public","typeLabel":"string"},"private":{"type":"string","description":"Returned by `GET /lists/{id}` only to the owner and to collaborators with a notes permission.","uniqueKey":"movies.items.[INDEX].note.private","typeLabel":"string"}},"uniqueKey":"movies.items.[INDEX].note","typeLabel":"object"}},"uniqueKey":"movies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"movies","typeLabel":"object[]"},"shows":{"type":"array","items":{"type":"object","description":"One title, in the same shape `POST /sync/history` takes. Needs `ids`, or a `title` (with `year` to disambiguate).","properties":{"ids":{"type":"object","description":"Any ID Simkl knows: `simkl` (or `simkl_id`, as `GET /lists/{id}` returns it), `tmdb`, `imdb`, `tvdb`, `mal`, `anidb`, `anilist`, `kitsu`, and the rest of the [supported IDs](/conventions/standard-media-objects). `0` and `\"\"` count as missing.","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"shows.items.[INDEX].ids.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"shows.items.[INDEX].ids.additionalProperties.oneOf.1","typeLabel":"integer"}],"uniqueKey":"shows.items.[INDEX].ids.additionalProperties","typeLabel":"string | integer"},"properties":{"simkl":{"type":"integer","example":53992,"uniqueKey":"shows.items.[INDEX].ids.simkl","typeLabel":"integer"},"simkl_id":{"type":"integer","uniqueKey":"shows.items.[INDEX].ids.simkl_id","typeLabel":"integer"},"tmdb":{"oneOf":[{"type":"string","uniqueKey":"shows.items.[INDEX].ids.tmdb.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"shows.items.[INDEX].ids.tmdb.oneOf.1","typeLabel":"integer"}],"uniqueKey":"shows.items.[INDEX].ids.tmdb","typeLabel":"string | integer"},"imdb":{"type":"string","uniqueKey":"shows.items.[INDEX].ids.imdb","typeLabel":"string"}},"uniqueKey":"shows.items.[INDEX].ids","typeLabel":"object"},"title":{"type":"string","uniqueKey":"shows.items.[INDEX].title","typeLabel":"string"},"year":{"type":"integer","uniqueKey":"shows.items.[INDEX].year","typeLabel":"integer"},"user_position":{"type":"integer","minimum":1,"description":"Put the title at this place in the list's own order, 1-based — the number `GET /lists/{id}` returns as `user_position`. Past the end means the end; the titles after it shift down.","uniqueKey":"shows.items.[INDEX].user_position","typeLabel":"integer"},"season":{"type":"integer","minimum":0,"description":"**Anime only.** Add the entry that covers this season instead of the base title. `0` means no hint. Ignored for TV and movies.","uniqueKey":"shows.items.[INDEX].season","typeLabel":"integer"},"seasons":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"number":{"type":"integer","minimum":0,"uniqueKey":"shows.items.[INDEX].seasons.items.[INDEX].number","typeLabel":"integer"}},"uniqueKey":"shows.items.[INDEX].seasons.items.[INDEX]","typeLabel":"object"},"description":"**Anime only.** Several seasons at once; each becomes its own entry, in season order.","uniqueKey":"shows.items.[INDEX].seasons","typeLabel":"object[]"},"note":{"type":"object","description":"Notes on this title. Trimmed, HTML removed, up to 4096 characters each. A note equal to the stored one is no change.","properties":{"public":{"type":"string","description":"Shown to everyone who can see the list.","uniqueKey":"shows.items.[INDEX].note.public","typeLabel":"string"},"private":{"type":"string","description":"Returned by `GET /lists/{id}` only to the owner and to collaborators with a notes permission.","uniqueKey":"shows.items.[INDEX].note.private","typeLabel":"string"}},"uniqueKey":"shows.items.[INDEX].note","typeLabel":"object"}},"uniqueKey":"shows.items.[INDEX]","typeLabel":"object"},"uniqueKey":"shows","typeLabel":"object[]"},"anime":{"type":"array","items":{"type":"object","description":"One title, in the same shape `POST /sync/history` takes. Needs `ids`, or a `title` (with `year` to disambiguate).","properties":{"ids":{"type":"object","description":"Any ID Simkl knows: `simkl` (or `simkl_id`, as `GET /lists/{id}` returns it), `tmdb`, `imdb`, `tvdb`, `mal`, `anidb`, `anilist`, `kitsu`, and the rest of the [supported IDs](/conventions/standard-media-objects). `0` and `\"\"` count as missing.","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"anime.items.[INDEX].ids.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"anime.items.[INDEX].ids.additionalProperties.oneOf.1","typeLabel":"integer"}],"uniqueKey":"anime.items.[INDEX].ids.additionalProperties","typeLabel":"string | integer"},"properties":{"simkl":{"type":"integer","example":53992,"uniqueKey":"anime.items.[INDEX].ids.simkl","typeLabel":"integer"},"simkl_id":{"type":"integer","uniqueKey":"anime.items.[INDEX].ids.simkl_id","typeLabel":"integer"},"tmdb":{"oneOf":[{"type":"string","uniqueKey":"anime.items.[INDEX].ids.tmdb.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"anime.items.[INDEX].ids.tmdb.oneOf.1","typeLabel":"integer"}],"uniqueKey":"anime.items.[INDEX].ids.tmdb","typeLabel":"string | integer"},"imdb":{"type":"string","uniqueKey":"anime.items.[INDEX].ids.imdb","typeLabel":"string"}},"uniqueKey":"anime.items.[INDEX].ids","typeLabel":"object"},"title":{"type":"string","uniqueKey":"anime.items.[INDEX].title","typeLabel":"string"},"year":{"type":"integer","uniqueKey":"anime.items.[INDEX].year","typeLabel":"integer"},"user_position":{"type":"integer","minimum":1,"description":"Put the title at this place in the list's own order, 1-based — the number `GET /lists/{id}` returns as `user_position`. Past the end means the end; the titles after it shift down.","uniqueKey":"anime.items.[INDEX].user_position","typeLabel":"integer"},"season":{"type":"integer","minimum":0,"description":"**Anime only.** Add the entry that covers this season instead of the base title. `0` means no hint. Ignored for TV and movies.","uniqueKey":"anime.items.[INDEX].season","typeLabel":"integer"},"seasons":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"number":{"type":"integer","minimum":0,"uniqueKey":"anime.items.[INDEX].seasons.items.[INDEX].number","typeLabel":"integer"}},"uniqueKey":"anime.items.[INDEX].seasons.items.[INDEX]","typeLabel":"object"},"description":"**Anime only.** Several seasons at once; each becomes its own entry, in season order.","uniqueKey":"anime.items.[INDEX].seasons","typeLabel":"object[]"},"note":{"type":"object","description":"Notes on this title. Trimmed, HTML removed, up to 4096 characters each. A note equal to the stored one is no change.","properties":{"public":{"type":"string","description":"Shown to everyone who can see the list.","uniqueKey":"anime.items.[INDEX].note.public","typeLabel":"string"},"private":{"type":"string","description":"Returned by `GET /lists/{id}` only to the owner and to collaborators with a notes permission.","uniqueKey":"anime.items.[INDEX].note.private","typeLabel":"string"}},"uniqueKey":"anime.items.[INDEX].note","typeLabel":"object"}},"uniqueKey":"anime.items.[INDEX]","typeLabel":"object"},"uniqueKey":"anime","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"remove_favorite":{"title":"remove_favorite","summary":"Unfavorite a movie","value":{"movies":[{"ids":{"simkl":53992}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b95b7b1f-8ade-4697-a6be-d737df77e426":{"description":"Done.","content":{"application/json":{"schema":{"type":"object","required":["deleted","not_found","lists"],"properties":{"deleted":{"type":"integer","description":"Titles taken off the list.","isRequired":true,"uniqueKey":"deleted","typeLabel":"integer"},"not_found":{"type":"array","items":{"type":"object","uniqueKey":"not_found.items.[INDEX]","typeLabel":"object"},"description":"Titles not on the list (a wrong media type included), echoed as you sent them.","isRequired":true,"uniqueKey":"not_found","typeLabel":"object[]"},"lists":{"type":"object","required":["movies","tv","anime"],"description":"The favorite list of each media type the request touched. See [Null and missing values](/conventions/null-values).","properties":{"movies":{"oneOf":[{"type":"object","description":"**Type 4 null** — the request had no movies title for that list.","required":["id","counts","updated_at"],"properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"lists.movies.oneOf.0.id","typeLabel":"integer"},"counts":{"type":"object","description":"Totals for the whole list, independent of the page you requested. `items` is the list's real size -- compare it with `pagination.total_items`, which reflects the current query.","required":["items","likes","followers","comments","collaborators"],"properties":{"items":{"type":"integer","description":"Titles in the list.","example":222,"isRequired":true,"uniqueKey":"lists.movies.oneOf.0.counts.\\items","typeLabel":"integer"},"likes":{"type":"integer","description":"Likes the list has received.","example":95,"isRequired":true,"uniqueKey":"lists.movies.oneOf.0.counts.likes","typeLabel":"integer"},"followers":{"type":"integer","description":"Users following the list.","example":104,"isRequired":true,"uniqueKey":"lists.movies.oneOf.0.counts.followers","typeLabel":"integer"},"comments":{"type":"integer","description":"Comments on the list.","example":0,"isRequired":true,"uniqueKey":"lists.movies.oneOf.0.counts.comments","typeLabel":"integer"},"collaborators":{"type":"integer","description":"Users who can edit the list besides the owner.","example":1,"isRequired":true,"uniqueKey":"lists.movies.oneOf.0.counts.collaborators","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"lists.movies.oneOf.0.counts","typeLabel":"object"},"updated_at":{"type":"string","format":"date-time","description":"UTC. Unchanged when the request changed nothing.","isRequired":true,"uniqueKey":"lists.movies.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"lists.movies.oneOf.0","typeLabel":"object"},{"type":"null","description":"**Type 4 null** — the request had no movies title for that list.","isRequired":true,"uniqueKey":"lists.movies.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lists.movies","typeLabel":"object | null"},"tv":{"oneOf":[{"type":"object","description":"**Type 4 null** — the request had no tv title for that list.","required":["id","counts","updated_at"],"properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"lists.tv.oneOf.0.id","typeLabel":"integer"},"counts":{"type":"object","description":"Totals for the whole list, independent of the page you requested. `items` is the list's real size -- compare it with `pagination.total_items`, which reflects the current query.","required":["items","likes","followers","comments","collaborators"],"properties":{"items":{"type":"integer","description":"Titles in the list.","example":222,"isRequired":true,"uniqueKey":"lists.tv.oneOf.0.counts.\\items","typeLabel":"integer"},"likes":{"type":"integer","description":"Likes the list has received.","example":95,"isRequired":true,"uniqueKey":"lists.tv.oneOf.0.counts.likes","typeLabel":"integer"},"followers":{"type":"integer","description":"Users following the list.","example":104,"isRequired":true,"uniqueKey":"lists.tv.oneOf.0.counts.followers","typeLabel":"integer"},"comments":{"type":"integer","description":"Comments on the list.","example":0,"isRequired":true,"uniqueKey":"lists.tv.oneOf.0.counts.comments","typeLabel":"integer"},"collaborators":{"type":"integer","description":"Users who can edit the list besides the owner.","example":1,"isRequired":true,"uniqueKey":"lists.tv.oneOf.0.counts.collaborators","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"lists.tv.oneOf.0.counts","typeLabel":"object"},"updated_at":{"type":"string","format":"date-time","description":"UTC. Unchanged when the request changed nothing.","isRequired":true,"uniqueKey":"lists.tv.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"lists.tv.oneOf.0","typeLabel":"object"},{"type":"null","description":"**Type 4 null** — the request had no tv title for that list.","isRequired":true,"uniqueKey":"lists.tv.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lists.tv","typeLabel":"object | null"},"anime":{"oneOf":[{"type":"object","description":"**Type 4 null** — the request had no anime title for that list.","required":["id","counts","updated_at"],"properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"lists.anime.oneOf.0.id","typeLabel":"integer"},"counts":{"type":"object","description":"Totals for the whole list, independent of the page you requested. `items` is the list's real size -- compare it with `pagination.total_items`, which reflects the current query.","required":["items","likes","followers","comments","collaborators"],"properties":{"items":{"type":"integer","description":"Titles in the list.","example":222,"isRequired":true,"uniqueKey":"lists.anime.oneOf.0.counts.\\items","typeLabel":"integer"},"likes":{"type":"integer","description":"Likes the list has received.","example":95,"isRequired":true,"uniqueKey":"lists.anime.oneOf.0.counts.likes","typeLabel":"integer"},"followers":{"type":"integer","description":"Users following the list.","example":104,"isRequired":true,"uniqueKey":"lists.anime.oneOf.0.counts.followers","typeLabel":"integer"},"comments":{"type":"integer","description":"Comments on the list.","example":0,"isRequired":true,"uniqueKey":"lists.anime.oneOf.0.counts.comments","typeLabel":"integer"},"collaborators":{"type":"integer","description":"Users who can edit the list besides the owner.","example":1,"isRequired":true,"uniqueKey":"lists.anime.oneOf.0.counts.collaborators","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"lists.anime.oneOf.0.counts","typeLabel":"object"},"updated_at":{"type":"string","format":"date-time","description":"UTC. Unchanged when the request changed nothing.","isRequired":true,"uniqueKey":"lists.anime.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"lists.anime.oneOf.0","typeLabel":"object"},{"type":"null","description":"**Type 4 null** — the request had no anime title for that list.","isRequired":true,"uniqueKey":"lists.anime.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lists.anime","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"lists","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"remove_favorite":{"title":"remove_favorite","summary":"Unfavorite a movie","description":"A title that is not a favorite, or whose type has no favorite list, comes back in `not_found`.","value":{"deleted":1,"not_found":[],"lists":{"movies":{"id":239308,"counts":{"items":0,"likes":0,"followers":0,"comments":0,"collaborators":0},"updated_at":"2026-11-13T16:58:43Z"},"tv":null,"anime":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"40abd27f-791a-47c6-8d42-420112b3d4fa":{"description":"As for adding to a list.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"empty_field","code":400,"message":"Send movies, shows or anime"},"examples":{"Example":{"title":"Example","value":{"error":"empty_field","code":400,"message":"Send movies, shows or anime"}}},"exampleType":"examples"}},"exampleType":"examples"},"4a02643c-1ac8-48bb-a5d2-a7a5924a1be3":{"description":"No usable token. `user_token_required` — no bearer from an AUTH V2 app; `user_token_failed` — no bearer from an AUTH V1 app; `invalid_token` — the token expired or was revoked (refresh it).","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"user_token_required","code":401,"message":"This client_id requires a user access token on every request"},"examples":{"Example":{"title":"Example","value":{"error":"user_token_required","code":401,"message":"This client_id requires a user access token on every request"}}},"exampleType":"examples"}},"exampleType":"examples"},"08e85dfb-364d-4ff0-8072-5657b4a36d00":{"description":"Refused. `premium_only` — the account is free (or, when adding collaborators, not VIP). `oauth2_token_required` — an AUTH V1 token. `insufficient_scope` — the token lacks `media:write`.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"premium_only","code":403,"message":"Custom lists over the API are available to Simkl Pro and VIP members only."},"examples":{"Example":{"title":"Example","value":{"error":"premium_only","code":403,"message":"Custom lists over the API are available to Simkl Pro and VIP members only."}}},"exampleType":"examples"}},"exampleType":"examples"},"f6dab985-224c-42af-b899-fea940f8f5f9":{"description":"The path is not a list route.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"url_failed","code":404,"message":"This page is not found"},"examples":{"Example":{"title":"Example","value":{"error":"url_failed","code":404,"message":"This page is not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"80f67a0f-0010-4936-b002-273a25eec73b":{"description":"Wrong verb for this path. The `Allow` header lists the right ones (`POST`).","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"method_not_allowed","code":405,"message":"Use POST"},"examples":{"Example":{"title":"Example","value":{"error":"method_not_allowed","code":405,"message":"Use POST"}}},"exampleType":"examples"}},"headers":{"Allow":{"description":"The verbs this path accepts.","schema":{"type":"string","example":"POST"}}},"exampleType":"examples"},"54429eca-2ef0-48bb-8f74-c1adffae40bc":{"description":"Too many requests in too short a window. Back off and retry with exponential backoff — see [Rate limits](/resources/rate-limits) for the playbook.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope for 4xx and 5xx responses. Branch on `error` (machine-readable identifier) — `message`, when present, is human-readable guidance and is **not stable across releases**.","properties":{"error":{"type":"string","description":"Machine-readable error identifier. Stable across responses — use this for programmatic branching in client code. Examples: `user_token_failed`, `client_id_failed`, `empty_field`, `wrong_parameter`, `id_err`, `rate_limit`.","example":"user_token_failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"integer","description":"HTTP status code echoed in the body for convenience — same value as the response status line. Always an integer.","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Human-readable error guidance. Optional — present on most errors, but not guaranteed. May reference the specific field or value that triggered the error. NOT stable; do not parse.","example":"Your client_id is wrong. Try another one","uniqueKey":"message","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"rate_limit","code":429},"examples":{"Example":{"title":"Example","value":{"error":"rate_limit","code":429}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"61ccd36d-aa91-4440-b325-dfc3f32f0588":{"bearerAuth":{"type":"http","scheme":"bearer","description":"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](/api-reference/auth).","x-default":"YOUR_ACCESS_TOKEN","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1ff7513b-7c65-431d-a68f-d379fa335309":{"url":"https://api.simkl.com","description":"Production API"},"23b65516-5008-4875-b78d-4bd0b879e4f4":{"url":"https://data.simkl.in","description":"CDN for static, public data files (Calendar + Trending). No auth required."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"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](/api-reference/auth).","x-default":"YOUR_ACCESS_TOKEN","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"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](/api-reference/auth).","format":"bearer","default":"YOUR_ACCESS_TOKEN","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"andrewmasyk","siteName":"Simkl API","title":"Remove favorites - Simkl API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T20:32:47.729Z","originalFileLocation":"api-reference/simkl/remove-favorites.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Beta, PRO and VIP. Needs an AUTH V2 token with the media:write scope, belonging to a Simkl PRO or VIP account. A free account gets 403 premium_only here — a real error, unlike the 200 upgrade card that GET /lists/{id} returns. Full walkthrough: Edit a custom list. Takes titles off the caller\u0026#x27;s favorite lists, each from the list of its own media type. Always 200.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Simkl API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Remove favorites - Simkl API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Beta, PRO and VIP. Needs an AUTH V2 token with the media:write scope, belonging to a Simkl PRO or VIP account. A free account gets 403 premium_only here — a real error, unlike the 200 upgrade card that GET /lists/{id} returns. Full walkthrough: Edit a custom list. Takes titles off the caller\u0026#x27;s favorite lists, each from the list of its own media type. Always 200.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Simkl API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.simkl.org/api-reference/simkl/remove-favorites\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://i.simkl.com/img_tv/apiary_logo_api.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Remove favorites - Simkl API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Beta, PRO and VIP. Needs an AUTH V2 token with the media:write scope, belonging to a Simkl PRO or VIP account. A free account gets 403 premium_only here — a real error, unlike the 200 upgrade card that GET /lists/{id} returns. Full walkthrough: Edit a custom list. Takes titles off the caller\u0026#x27;s favorite lists, each from the list of its own media type. Always 200.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://i.simkl.com/img_tv/apiary_logo_api.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/andrewmasyk/IyI3OjL228cw9rDC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Simkl API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.simkl.org/api-reference/simkl/remove-favorites\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/simkl/remove-favorites.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.simkl.org/#organization\",\"name\":\"Simkl API\",\"url\":\"https://api.simkl.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/andrewmasyk/yVND0Vg0vHbm_kqK/logo/light.svg?fit=max\u0026auto=format\u0026n=yVND0Vg0vHbm_kqK\u0026q=85\u0026s=3ed4c7fdfb9f19455db11c9a13dd466e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api.simkl.org#website\",\"name\":\"Simkl API\",\"url\":\"https://api.simkl.org\",\"publisher\":{\"@id\":\"https://api.simkl.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.simkl.org/api-reference/simkl/remove-favorites#webpage\",\"url\":\"https://api.simkl.org/api-reference/simkl/remove-favorites\",\"name\":\"Remove favorites\",\"description\":\"Beta, PRO and VIP. Needs an AUTH V2 token with the media:write scope, belonging to a Simkl PRO or VIP account. A free account gets 403 premium_only here — a real error, unlike the 200 upgrade card that GET /lists/{id} returns. Full walkthrough: Edit a custom list. Takes titles off the caller's favorite lists, each from the list of its own media type. Always 200.\",\"dateModified\":\"2026-11-15T20:32:47.729Z\",\"isPartOf\":{\"@id\":\"https://api.simkl.org#website\"},\"breadcrumb\":{\"@id\":\"https://api.simkl.org/api-reference/simkl/remove-favorites#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.simkl.org/api-reference/simkl/remove-favorites#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Custom Lists\",\"item\":\"https://api.simkl.org/api-reference/lists\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Remove favorites\",\"item\":\"https://api.simkl.org/api-reference/simkl/remove-favorites\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.simkl.org/api-reference/simkl/remove-favorites#apireference\",\"headline\":\"Remove favorites\",\"name\":\"Remove favorites\",\"description\":\"Beta, PRO and VIP. Needs an AUTH V2 token with the media:write scope, belonging to a Simkl PRO or VIP account. A free account gets 403 premium_only here — a real error, unlike the 200 upgrade card that GET /lists/{id} returns. Full walkthrough: Edit a custom list. Takes titles off the caller's favorite lists, each from the list of its own media type. Always 200.\",\"url\":\"https://api.simkl.org/api-reference/simkl/remove-favorites\",\"mainEntityOfPage\":{\"@id\":\"https://api.simkl.org/api-reference/simkl/remove-favorites#webpage\"},\"image\":\"https://i.simkl.com/img_tv/apiary_logo_api.png\",\"dateModified\":\"2026-11-15T20:32:47.729Z\",\"publisher\":{\"@id\":\"https://api.simkl.org/#organization\"},\"isPartOf\":{\"@id\":\"https://api.simkl.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Simkl API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Simkl API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/simkl/remove-favorites.md","siteName":"Simkl API","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Documentation","icon":"book-open","align":"start","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","align":"start","groups":[{"group":"API Reference","icon":"book-bookmark","pages":[{"title":"Introduction","sidebarTitle":"Introduction","icon":"circle-info","href":"/api-reference/introduction"},{"title":"Pagination","icon":"list-ol","href":"/conventions/pagination"},{"title":"Rate limits","icon":"gauge","href":"/resources/rate-limits"},{"title":"Errors and status codes","sidebarTitle":"Errors","icon":"triangle-exclamation","href":"/conventions/errors"}]},{"group":"Trending","icon":"fire","pages":[{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"}]},{"group":"Calendar","icon":"calendar","pages":[{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Redirect","icon":"arrow-right","pages":[{"title":"Redirect \u0026 deep-linking","sidebarTitle":"About Redirect","icon":"circle-info","href":"/api-reference/redirect"},{"title":"Resolve any ID and redirect to Simkl","deprecated":null,"version":null,"sidebarTitle":"Redirect","openapi":"/openapi.json get /redirect","href":"/api-reference/simkl/redirect"}]},{"group":"Auth","icon":"shield-halved","pages":[{"title":"Set up authentication","sidebarTitle":"Set up auth","icon":"wrench","href":"/api-reference/auth"},{"group":"AUTH V2","icon":"shield-check","pages":[{"title":"AUTH V2 overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/auth-v2"},{"group":"OAuth","icon":"lock","pages":[{"title":"OAuth 2.0 flow (AUTH V2)","sidebarTitle":"Walkthrough","icon":"browser","href":"/api-reference/oauth2-authorization-code"},{"title":"PKCE in AUTH V2","sidebarTitle":"PKCE","icon":"shield-keyhole","href":"/api-reference/oauth2-pkce"},{"title":"Authorize (V2)","deprecated":null,"version":null,"sidebarTitle":"Authorize","playground":"simple","openapi":"/openapi.json get /oauth2/authorize","href":"/api-reference/simkl/oauth2-authorize"},{"title":"Token (V2)","deprecated":null,"version":null,"sidebarTitle":"Token (code, refresh, device)","openapi":"/openapi.json post /oauth2/token","href":"/api-reference/simkl/oauth2-token"}]},{"group":"Device / PIN","icon":"tv","pages":[{"title":"Device / PIN flow (AUTH V2)","sidebarTitle":"Walkthrough","icon":"qrcode","href":"/api-reference/oauth2-device"},{"title":"Device authorization (V2)","deprecated":null,"version":null,"sidebarTitle":"Request device code","openapi":"/openapi.json post /oauth2/device","href":"/api-reference/simkl/oauth2-device"}]},{"group":"Tokens \u0026 scopes","icon":"rotate","pages":[{"title":"Tokens and refresh (AUTH V2)","sidebarTitle":"Refreshing","icon":"key","href":"/api-reference/oauth2-tokens"},{"title":"Scopes (AUTH V2)","sidebarTitle":"Scopes","icon":"list-check","href":"/api-reference/oauth2-scopes"},{"title":"Revoke token (V2)","deprecated":null,"version":null,"sidebarTitle":"Revoke token","openapi":"/openapi.json post /oauth2/revoke","href":"/api-reference/simkl/oauth2-revoke"}]},{"title":"OAuth client libraries (AUTH V2)","sidebarTitle":"Client libraries","icon":"puzzle-piece","href":"/api-reference/oauth2-libraries"}]},{"group":"AUTH V1","icon":"clock-rotate-left","pages":[{"title":"AUTH V1 overview","sidebarTitle":"Overview","icon":"clock-rotate-left","href":"/api-reference/auth-v1"},{"title":"Public PKCE (AUTH V1)","sidebarTitle":"Public PKCE","icon":"shield-keyhole","href":"/api-reference/oauth-pkce"},{"group":"OAuth","icon":"lock","pages":[{"title":"OAuth flow (AUTH V1)","sidebarTitle":"OAuth flow","icon":"route","href":"/api-reference/oauth"},{"title":"Authorize a user","deprecated":null,"version":null,"sidebarTitle":"OAuth authorize","playground":"simple","openapi":"/openapi.json get /oauth/authorize","href":"/api-reference/simkl/authorize"},{"title":"Exchange an authorization code for an access token","deprecated":null,"version":null,"sidebarTitle":"OAuth token","openapi":"/openapi.json post /oauth/token","href":"/api-reference/simkl/exchange-token"}]},{"group":"Device / PIN","icon":"tv","pages":[{"title":"PIN flow (AUTH V1)","sidebarTitle":"PIN flow","icon":"route","href":"/api-reference/pin"},{"title":"Request a PIN code","deprecated":null,"version":null,"sidebarTitle":"Request PIN","openapi":"/openapi.json get /oauth/pin","href":"/api-reference/simkl/get-pin"},{"title":"Poll PIN code for the access token","deprecated":null,"version":null,"sidebarTitle":"Poll PIN","openapi":"/openapi.json get /oauth/pin/{user_code}","href":"/api-reference/simkl/check-pin"}]},{"title":"OAuth client libraries","sidebarTitle":"Client libraries","icon":"puzzle-piece","href":"/api-reference/oauth-libraries"}]}]},{"group":"Scrobble","icon":"play","pages":[{"title":"How scrobbling works","icon":"diagram-project","href":"/api-reference/scrobble"},{"title":"Check-in","deprecated":null,"version":null,"sidebarTitle":"Check-in","openapi":"/openapi.json post /scrobble/checkin","href":"/api-reference/simkl/scrobble-checkin"},{"title":"Pause","deprecated":null,"version":null,"sidebarTitle":"Pause","openapi":"/openapi.json post /scrobble/pause","href":"/api-reference/simkl/scrobble-pause"},{"title":"Start","deprecated":null,"version":null,"sidebarTitle":"Start","openapi":"/openapi.json post /scrobble/start","href":"/api-reference/simkl/scrobble-start"},{"title":"Stop","deprecated":null,"version":null,"sidebarTitle":"Stop","openapi":"/openapi.json post /scrobble/stop","href":"/api-reference/simkl/scrobble-stop"}]},{"group":"Playback","icon":"play-pause","pages":[{"title":"How playbacks work","icon":"play-pause","href":"/api-reference/playback"},{"title":"Get paused playback sessions for every type","deprecated":null,"version":null,"sidebarTitle":"Playback (all types)","openapi":"/openapi.json get /sync/playback","href":"/api-reference/simkl/get-playback-sessions-all"},{"title":"Get paused playback sessions for one type","deprecated":null,"version":null,"sidebarTitle":"Playback (by type)","openapi":"/openapi.json get /sync/playback/{type}","href":"/api-reference/simkl/get-playback-sessions"},{"title":"Delete Playback","deprecated":null,"version":null,"sidebarTitle":"Delete Playback","openapi":"/openapi.json delete /sync/playback/{id}","href":"/api-reference/simkl/delete-playback"}]},{"group":"Sync","icon":"arrows-rotate","pages":[{"title":"Sync","sidebarTitle":"Sync","icon":"diagram-project","href":"/api-reference/sync"},{"title":"Get Last Activities","deprecated":null,"version":null,"sidebarTitle":"Last Activities","openapi":"/openapi.json get /sync/activities","href":"/api-reference/simkl/get-activities"},{"title":"Add to Watchlist","deprecated":null,"version":null,"sidebarTitle":"Add to Watchlist","openapi":"/openapi.json post /sync/add-to-list","href":"/api-reference/simkl/add-to-list"},{"title":"Get all items of one type in one status bucket","deprecated":null,"version":null,"sidebarTitle":"All items","openapi":"/openapi.json get /sync/all-items/{type}/{status}","href":"/api-reference/simkl/get-all-items"},{"title":"Add to History","deprecated":null,"version":null,"sidebarTitle":"Add to History","openapi":"/openapi.json post /sync/history","href":"/api-reference/simkl/add-to-history"},{"title":"Remove from History","deprecated":null,"version":null,"sidebarTitle":"Remove from History","openapi":"/openapi.json post /sync/history/remove","href":"/api-reference/simkl/remove-from-history"},{"title":"Add Ratings","deprecated":null,"version":null,"sidebarTitle":"Add Ratings","openapi":"/openapi.json post /sync/ratings","href":"/api-reference/simkl/add-ratings"},{"title":"Remove Ratings","deprecated":null,"version":null,"sidebarTitle":"Remove Ratings","openapi":"/openapi.json post /sync/ratings/remove","href":"/api-reference/simkl/remove-ratings"},{"title":"Get the user's rated items, filtered by type and rating","deprecated":null,"version":null,"sidebarTitle":"User ratings","openapi":"/openapi.json get /sync/ratings/{type}/{rating}","href":"/api-reference/simkl/get-user-ratings"},{"title":"Look up watched status for items","deprecated":null,"version":null,"sidebarTitle":"Lookup watched","openapi":"/openapi.json post /sync/watched","href":"/api-reference/simkl/get-watched"}]},{"group":"Custom Lists","icon":"list","pages":[{"title":"Custom lists","sidebarTitle":"Overview","icon":"list","href":"/api-reference/lists"},{"title":"Get a custom list","deprecated":null,"version":null,"sidebarTitle":"Get custom list","openapi":"/openapi.json get /lists/{id}","href":"/api-reference/simkl/get-list"},{"title":"Get a user's custom lists","deprecated":null,"version":null,"sidebarTitle":"Get user's custom lists","openapi":"/openapi.json get /lists/user/{userId}","href":"/api-reference/simkl/get-user-lists"},{"title":"Create a custom list","deprecated":null,"version":null,"sidebarTitle":"Create custom list","openapi":"/openapi.json post /lists","href":"/api-reference/simkl/create-list"},{"title":"Edit a custom list","deprecated":null,"version":null,"sidebarTitle":"Edit custom list","openapi":"/openapi.json post /lists/{id}","href":"/api-reference/simkl/update-list"},{"title":"Delete a custom list","deprecated":null,"version":null,"sidebarTitle":"Delete custom list","openapi":"/openapi.json delete /lists/{id}","href":"/api-reference/simkl/delete-list"},{"title":"Add or reorder titles in a custom list","deprecated":null,"version":null,"sidebarTitle":"Add list items","openapi":"/openapi.json post /lists/{id}/items","href":"/api-reference/simkl/add-list-items"},{"title":"Remove titles from a custom list","deprecated":null,"version":null,"sidebarTitle":"Remove list items","openapi":"/openapi.json post /lists/{id}/items/remove","href":"/api-reference/simkl/remove-list-items"},{"title":"Add favorites","description":"**Beta, PRO and VIP.** Needs an [AUTH V2](/api-reference/auth-v2) token with the `media:write` [scope](/api-reference/oauth2-scopes), belonging to a Simkl **PRO or VIP** account. A free account gets `403 premium_only` here — a real error, unlike the `200` upgrade card that `GET /lists/{id}` returns. Full walkthrough: [Edit a custom list](/guides/custom-lists#edit-a-custom-list).\n\nFavorites without a list ID — the heart on simkl.com. Each title goes to the caller's favorite list **of its own media type**, so one request may mix `movies`, `shows` and `anime`. A first favorite of a type creates that list (private if the account is private).\n\nSame body and ordering rules as [adding to a list](/api-reference/simkl/add-list-items), including `user_position` and `?allow_reorder=yes`. The response carries a `lists` object — the favorite list of each type you touched, `null` for the others — instead of `list`. Favorites move the `favorites` bucket in [`/sync/activities`](/api-reference/simkl/get-activities).","deprecated":null,"version":null,"sidebarTitle":"Add favorites","openapi":"/openapi.json post /lists/favorites","href":"/api-reference/simkl/add-favorites"},{"title":"Remove favorites","deprecated":null,"version":null,"sidebarTitle":"Remove favorites","openapi":"/openapi.json post /lists/favorites/remove","href":"/api-reference/simkl/remove-favorites"}]},{"group":"Search","icon":"magnifying-glass","pages":[{"title":"About Search","description":"Look up items by ID, by title, by file name, or pull a random item.","icon":"circle-info","href":"/api-reference/search"},{"title":"Find an item by file name","deprecated":null,"version":null,"sidebarTitle":"By file","openapi":"/openapi.json post /search/file","href":"/api-reference/simkl/search-by-file"},{"title":"Find items by external ID","deprecated":null,"version":null,"sidebarTitle":"By ID","openapi":"/openapi.json get /search/id","href":"/api-reference/simkl/search-by-id"},{"title":"Random pick","deprecated":null,"version":null,"sidebarTitle":"Random","openapi":"/openapi.json post /search/random","href":"/api-reference/simkl/search-random"},{"title":"Search by text query","deprecated":null,"version":null,"sidebarTitle":"By text","openapi":"/openapi.json get /search/{type}","href":"/api-reference/simkl/search-by-text"}]},{"group":"TV","icon":"tv","pages":[{"title":"About TV","icon":"circle-info","href":"/api-reference/tv"},{"group":"Look up a show","icon":"magnifying-glass","pages":[{"title":"TV show details","deprecated":null,"version":null,"sidebarTitle":"TV details","openapi":"/openapi.json get /tv/{id}","href":"/api-reference/simkl/get-tv-show"},{"title":"List episodes for a TV show","deprecated":null,"version":null,"sidebarTitle":"TV episodes","openapi":"/openapi.json get /tv/episodes/{id}","href":"/api-reference/simkl/get-tv-episodes"}]},{"group":"Browse \u0026 discover","icon":"compass","pages":[{"title":"TV shows airing today, tomorrow, or on a specific date","deprecated":null,"version":null,"sidebarTitle":"Airing TV","openapi":"/openapi.json get /tv/airing","href":"/api-reference/simkl/get-tv-airing"},{"title":"TV premieres (new + upcoming)","deprecated":null,"version":null,"sidebarTitle":"Premieres","openapi":"/openapi.json get /tv/premieres/{param}","href":"/api-reference/simkl/get-tv-premieres"},{"title":"Top-rated TV shows","deprecated":null,"version":null,"sidebarTitle":"Best of","openapi":"/openapi.json get /tv/best/{filter}","href":"/api-reference/simkl/get-best-tv"},{"title":"TV by genre","deprecated":null,"version":null,"sidebarTitle":"Genres","openapi":"/openapi.json get /tv/genres/{genre}/{type}/{country}/{network}/{year}/{sort}","href":"/api-reference/simkl/get-tv-genres"}]},{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"},{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Anime","icon":"dragon","pages":[{"title":"About Anime","icon":"circle-info","href":"/api-reference/anime"},{"group":"Look up an anime","icon":"magnifying-glass","pages":[{"title":"Anime details","deprecated":null,"version":null,"sidebarTitle":"Anime details","openapi":"/openapi.json get /anime/{id}","href":"/api-reference/simkl/get-anime"},{"title":"List episodes for an anime","deprecated":null,"version":null,"sidebarTitle":"Anime episodes","openapi":"/openapi.json get /anime/episodes/{id}","href":"/api-reference/simkl/get-anime-episodes"}]},{"group":"Browse \u0026 discover","icon":"compass","pages":[{"title":"Anime airing today, tomorrow, or on a specific date","deprecated":null,"version":null,"sidebarTitle":"Airing anime","openapi":"/openapi.json get /anime/airing","href":"/api-reference/simkl/get-anime-airing"},{"title":"Anime premieres (new + upcoming)","deprecated":null,"version":null,"sidebarTitle":"Premieres","openapi":"/openapi.json get /anime/premieres/{param}","href":"/api-reference/simkl/get-anime-premieres"},{"title":"Top-rated anime","deprecated":null,"version":null,"sidebarTitle":"Best of","openapi":"/openapi.json get /anime/best/{filter}","href":"/api-reference/simkl/get-best-anime"},{"title":"Anime by genre","deprecated":null,"version":null,"sidebarTitle":"Genres","openapi":"/openapi.json get /anime/genres/{genre}/{type}/{network}/{year}/{sort}","href":"/api-reference/simkl/get-anime-genres"}]},{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"},{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Movies","icon":"film","pages":[{"title":"About Movies","icon":"circle-info","href":"/api-reference/movies"},{"title":"Movie details","deprecated":null,"version":null,"sidebarTitle":"Movie details","openapi":"/openapi.json get /movies/{id}","href":"/api-reference/simkl/get-movie"},{"title":"Movies by genre","deprecated":null,"version":null,"sidebarTitle":"Genres","openapi":"/openapi.json get /movies/genres/{genre}/{type}/{country}/{year}/{sort}","href":"/api-reference/simkl/get-movies-genres"},{"title":"Trending data files","sidebarTitle":"Trending","icon":"fire","href":"/api-reference/trending"},{"title":"Calendar data files","sidebarTitle":"Calendar","icon":"calendar","href":"/api-reference/calendar"}]},{"group":"Ratings","icon":"star","pages":[{"title":"About Ratings","icon":"circle-info","href":"/api-reference/ratings"},{"title":"Community ratings for items in the user's watchlist","deprecated":null,"version":null,"sidebarTitle":"Watchlist ratings","openapi":"/openapi.json get /ratings/{type}","href":"/api-reference/simkl/get-watchlist-ratings"}]},{"group":"Users","icon":"user","pages":[{"title":"About Users","icon":"circle-info","href":"/api-reference/users"},{"title":"Redirect to a user's last-watched cover image","deprecated":null,"version":null,"sidebarTitle":"Cover image","openapi":"/openapi.json get /users/recently-watched-background/{user_id}","href":"/api-reference/simkl/get-recently-watched-image"},{"title":"Get the authenticated user's settings","deprecated":null,"version":null,"sidebarTitle":"User settings","openapi":"/openapi.json get /users/settings","href":"/api-reference/simkl/get-user-settings"},{"title":"Get a user's watch statistics","deprecated":null,"version":null,"sidebarTitle":"User stats","openapi":"/openapi.json get /users/{user_id}/stats","href":"/api-reference/simkl/get-user-stats"}]},{"group":"Changes","icon":"code-compare","pages":[{"title":"Recently changed catalog items","deprecated":null,"version":null,"sidebarTitle":"Recent changes","openapi":"/openapi.json get /changes","href":"/api-reference/simkl/get-changes"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","align":"start","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Remove favorites - Simkl API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}