Remove from history

Delete plays from your watch history.

DELETE https://cotlet.dev/api/v1/trakt/histories

write

Removes the given titles from your history, all plays of each one. Use get_history first to see which plays you are deleting. add_to_history logs a play again with a date. It reaches no one, so it needs no confirmation.

Parameters

Parameters: remove_from_history
NameTypeDescription
items array required array Titles to change. Each item is an object: type ('movie', 'show', 'season' or 'episode'), title and year, or trakt_id from search_titles. Seasons and episodes also take season and episode numbers. add_to_history also takes watched_at, rate_titles takes rating.

Request

cURL
curl -X DELETE "https://cotlet.dev/api/v1/trakt/histories?items=items" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("trakt", "remove_from_history", {"items":"items"})
Node.js
const result = await cotlet.call('trakt', 'remove_from_history', {"items":"items"});
CLI
cotlet call trakt remove_from_history --data '{"items":"items"}'

Example response

JSON

{
  "removed": {
    "movies": 0,
    "episodes": 1
  },
  "not_found": []
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.