Add to list

Add titles to one of your custom lists.

POST https://cotlet.dev/api/v1/trakt/lists/{list_id}

write Confirm

Adds the given titles to a list. Titles already on it come back as already_on_list and the call fails with an account-limit error when the list is full. If the list is public, other people see the change. Use list_lists to check the privacy first. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: add_to_list
NameTypeDescription
list_id string required string List ID or slug from list_lists.
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 POST https://cotlet.dev/api/v1/trakt/lists/list_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":"items"}'
Python
result = client.call("trakt", "add_to_list", {"list_id":"list_8c41d2","items":"items"})
Node.js
const result = await cotlet.call('trakt', 'add_to_list', {"list_id":"list_8c41d2","items":"items"});
CLI
cotlet call trakt add_to_list --data '{"list_id":"list_8c41d2","items":"items"}'

Example response

JSON

{
  "added": {
    "movies": 0,
    "shows": 5
  },
  "already_on_list": 0,
  "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.