Mutations
Every aniLink.anilist.mutation.* method requires authentication. Calling one without a token throws AniLinkAuthError. Mutations are never retried by the default retry policy unless you opt in.
Lists
| Operation | Purpose |
|---|---|
saveMediaListEntry | Create or update a list entry |
updateMediaListEntries | Update many entries at once |
deleteMediaListEntry | Delete an entry |
deleteCustomList | Delete a custom list |
Users
| Operation | Purpose |
|---|---|
updateUser | Update viewer preferences and profile |
Activity
| Operation | Purpose |
|---|---|
saveTextActivity | Create or update a text activity |
saveMessageActivity | Create or update a message activity |
saveListActivity | Update a list activity (mod only) |
deleteActivity | Delete an activity |
toggleActivityPin | Pin or unpin an activity |
toggleActivitySubscription | Subscribe or unsubscribe |
saveActivityReply | Create or update a reply |
deleteActivityReply | Delete a reply |
toggleLike | Toggle a like |
toggleLikeV2 | Toggle a like (v2 likeable types) |
Community
| Operation | Purpose |
|---|---|
saveThread | Create or update a thread |
deleteThread | Delete a thread |
toggleThreadSubscription | Subscribe or unsubscribe |
saveThreadComment | Create or update a comment |
deleteThreadComment | Delete a comment |
Reviews & recommendations
| Operation | Purpose |
|---|---|
saveReview | Create or update a review |
deleteReview | Delete a review |
rateReview | Rate a review |
saveRecommendation | Save a recommendation rating |
Social & favourites
| Operation | Purpose |
|---|---|
toggleFollow | Follow or unfollow a user |
toggleFavourite | Toggle a favourite |
updateFavouriteOrder | Reorder favourites |
AniChart
| Operation | Purpose |
|---|---|
updateAniChartSettings | Update AniChart settings |
updateAniChartHighlights | Update AniChart highlights |
Example
typescript
const aniLink = new AniLink("anilist-token");
const entry = await aniLink.anilist.mutation.saveMediaListEntry({
mediaId: 143271,
status: "CURRENT",
score: 8.5,
progress: 3,
});Errors
Mutations throw AniLinkAuthError (no token), AniLinkGraphQLError (validation failures inside HTTP 200), AniLinkApiError (HTTP-level failures), and AniLinkNetworkError (transport). See Error handling.
Next steps
- Mutation operation reference — variables per mutation.
- Retries & resilience — opting into mutation retries.