Update an entry on your AniList list
update_list_entryIdempotent
Update a specific entry on your AniList, identified by its list-entry ID, to change status, score, progress, notes, dates, and more.
Instructions
[Requires login] Update an existing entry on the authenticated user's own AniList list by its list-entry ID (NOT the media ID — get it from get_user_list, or from add_list_entry's response). Only set the fields you want to change. The response echoes every field this tool can set, as AniList actually stored it — check it instead of assuming the write landed verbatim, especially for advancedScores and customLists, which AniList zeroes/replaces rather than merges.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | New free-text notes (per AniList's own schema, capped at 6000 characters). | |
| score | No | New score out of 10 (decimals allowed), always on this scale regardless of the account's configured scoreFormat (set via update_user) — no conversion needed. | |
| repeat | No | New rewatch/reread count (per AniList's own schema, capped at 1000). | |
| status | No | New list status. | |
| private | No | Hide/unhide this entry from your public list. | |
| priority | No | New list priority (higher = more important; per AniList's own schema, capped at 255). | |
| progress | No | New episodes watched / chapters read. | |
| startedAt | No | New start date. | |
| completedAt | No | New completion date. | |
| customLists | No | New set of custom lists for this entry — REPLACES this entry's full set of enabled lists, not merged: naming only a subset silently turns OFF every other list this entry was previously filed under (confirmed live for add_list_entry's identical field; this tool writes the same underlying value), it doesn't leave them alone. Include every list name you want this entry to stay tagged with, not just the one you're changing. Also, the list must already exist on the account (update_user's `animeListOptions`/`mangaListOptions` `customLists`) — naming one that doesn't exist yet is silently a no-op, not an error. | |
| listEntryId | Yes | The list ENTRY id to update (not the media id). | |
| advancedScores | No | New per-category scores, keyed and error-checked the same way as add_list_entry (errors if advanced scoring is disabled, or a key doesn't match a configured category). Unlike this tool's other fields, this one is NOT a true partial update: any configured category you omit is set to 0, not left at its previous value — pass every category if you're only changing one. Also stored positionally, not by name — same read-time reinterpretation risk as add_list_entry's `advancedScores` if the account's category order (update_user's `advancedScoring`) is later renamed/reordered. | |
| progressVolumes | No | New volumes read (manga only). | |
| hiddenFromStatusLists | No | Hide/unhide this entry from the public status-grouped list views (e.g. 'Watching') while still counting it in statistics — distinct from `private`, which hides the entry entirely. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entry | Yes |