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
| Name | Type | Description |
|---|---|---|
| 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 -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"}' result = client.call("trakt", "add_to_list", {"list_id":"list_8c41d2","items":"items"}) const result = await cotlet.call('trakt', 'add_to_list', {"list_id":"list_8c41d2","items":"items"}); cotlet call trakt add_to_list --data '{"list_id":"list_8c41d2","items":"items"}' Example response
{
"added": {
"movies": 0,
"shows": 5
},
"already_on_list": 0,
"not_found": []
}