Mutations
Every aniLink.anilist.mutation.* method requires authentication. Without a token, a mutation throws AniLinkAuthError. The default retry policy never retries mutations unless you enable retries.
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 when you omit a token. They also throw AniLinkGraphQLError for validation failures inside an HTTP 200 response, AniLinkApiError for HTTP-level failures, and AniLinkNetworkError for transport errors. Error handling covers every error type.
Next steps
- Mutation operation reference, with variables for each mutation.
- Retries & resilience, including how to opt into mutation retries.