Kavita Reading List API

The Reading List API from Kavita — 26 operation(s) for reading list.

GitHub OpenAPI

Operations 27

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/ReadingList Get one reading list · Fetches a single Reading List #
Ask an LLM
“How do I fetch a single reading list by its ID?”
“Can I look up a reading list by its ID?”
Tell an agent
Get reading list {readingListId}.
Show me the details of reading list {readingListId}.
DELETE /api/ReadingList Delete a reading list · Deletes a reading list #
Ask an LLM
“How do I delete a reading list?”
“Can I remove a reading list by its ID?”
Tell an agent destructive · confirm first
Delete reading list {readingListId}.
Remove the reading list {readingListId}.
POST /api/ReadingList/lists List a user's reading lists · Returns reading lists (paginated) for a given user #
Ask an LLM
“What reading lists do I have?”
“Can I sort my reading lists by last modified?”
Tell an agent
List my reading lists.
Show my reading lists sorted by {sortByLastModified}.
POST /api/ReadingList/all Search a user's reading lists · Returns reading lists (paginated) for a given user #
Ask an LLM
“How do I search reading lists by a series or person?”
“Can I find reading lists that contain a given series?”
Tell an agent
Search my reading lists for series {id}.
Find reading lists matching {statements}.
GET /api/ReadingList/lists-for-series Find reading lists a series is in · Returns all Reading Lists the user has access to that the given series within it #
Ask an LLM
“Which reading lists contain a particular series?”
“Can I see every list a series is part of?”
Tell an agent
Find reading lists that contain series {seriesId}.
Show the lists series {seriesId} is in.
GET /api/ReadingList/lists-for-chapter Find reading lists a chapter is in · Returns all Reading Lists the user has access to that has the given chapter… #
Ask an LLM
“Which reading lists include a given chapter?”
“Can I see every list a chapter belongs to?”
Tell an agent
Find reading lists that contain chapter {chapterId}.
Show the lists chapter {chapterId} is in.
GET /api/ReadingList/items List items in a reading list · Fetches all reading list items for a given list including rich metadata around… #
Ask an LLM
“What items are in a reading list?”
“Can I get rich metadata for each item in a list?”
Tell an agent
List the items in reading list {readingListId}.
Show every item in list {readingListId}.
POST /api/ReadingList/update-position Reorder an item in a reading list · Updates an items position #
Ask an LLM
“How do I move an item to a new position in a reading list?”
“Can I reorder items within a list?”
Tell an agent
Move item {readingListItemId} in list {readingListId} to position {toPosition}.
Reorder item {readingListItemId} in {readingListId} to {toPosition}.
POST /api/ReadingList/delete-item Remove an item from a reading list · Deletes a list item from the list. Item orders will update as a result #
Ask an LLM
“How do I remove an item from a reading list?”
“Does removing an item reorder the list?”
Tell an agent destructive · confirm first
Remove item {readingListItemId} from reading list {readingListId}.
Delete item {readingListItemId} in list {readingListId}.
POST /api/ReadingList/remove-read Remove fully read items from a list · Removes all entries that are fully read from the reading list #
Ask an LLM
“How do I clean a reading list by removing books I've finished?”
“Can I purge all read entries from a reading list?”
Tell an agent destructive · confirm first
Remove all fully read entries from reading list {readingListId}.
Clean list {readingListId} of finished items.
POST /api/ReadingList/create Create a Kavita reading list · Creates a new List with a unique title. Returns the new ReadingList back #
Ask an LLM
“How do I create a new reading list?”
“Can I give a reading list a unique title?”
Tell an agent
Create a reading list titled {title}.
Make a new Kavita reading list called {title}.
POST /api/ReadingList/update Rename or edit a reading list · Update the properties (title, summary) of a reading list #
Ask an LLM
“How do I rename a reading list?”
“Can I change a list's summary or tags?”
Tell an agent
Rename reading list {readingListId} to {title}.
Update list {readingListId} with summary {summary}.
POST /api/ReadingList/update-by-series Add all chapters of a series to a list · Adds all chapters from a Series to a reading list #
Ask an LLM
“How do I add every chapter of a series to a reading list?”
“Can I bulk-add a whole series to a list?”
Tell an agent
Add all chapters of series {seriesId} to reading list {readingListId}.
Bulk-add series {seriesId} to list {readingListId}.
POST /api/ReadingList/update-by-multiple Add chapters from several volumes to a list · Adds all chapters from a list of volumes and chapters to a reading list #
Ask an LLM
“How do I add chapters from a list of volumes to a reading list?”
“Can I bulk-add several volumes to a list by volume IDs?”
Tell an agent
Add chapters {chapterIds} from series {seriesId} to list {readingListId}.
Bulk-add volumes {volumeIds} to reading list {readingListId}.
POST /api/ReadingList/update-by-multiple-series Add several whole series to a reading list · Adds all chapters from a list of series to a reading list #
Ask an LLM
“How do I put every chapter from a batch of series into one reading list?”
“Can I add multiple series to a reading list in a single request?”
Tell an agent
Add all chapters from the series {seriesIds} to reading list {readingListId} in one call.
Load the multiple series {seriesIds} into my list {readingListId}.
POST /api/ReadingList/update-by-volume Add all chapters of one volume to a list · Create api reading list update by volume #
Ask an LLM
“How do I add every chapter of a single volume to a reading list?”
“Can I bulk-add one volume to a list?”
Tell an agent
Add all chapters of volume {volumeId} from series {seriesId} to list {readingListId}.
Bulk-add volume {volumeId} of {seriesId} to reading list {readingListId}.
POST /api/ReadingList/update-by-chapter Add one chapter to a reading list · Create api reading list update by chapter #
Ask an LLM
“How do I add a single chapter to a reading list?”
“Can I add one chapter of a series to a list?”
Tell an agent
Add chapter {chapterId} of series {seriesId} to reading list {readingListId}.
Add chapter {chapterId} to list {readingListId}.
GET /api/ReadingList/people List contributors to a reading list · Returns a list of a given role associated with the reading list #
Ask an LLM
“Who are the writers or artists credited on a reading list?”
“Can I see the people in a given role on a list?”
Tell an agent
List people with role {role} on reading list {readingListId}.
Show {role} contributors for list {readingListId}.
GET /api/ReadingList/all-people List all contributors to a reading list · Returns all people in given roles for a reading list #
Ask an LLM
“Which writers, artists and other people are credited across a reading list?”
“Can I get every contributor on a list regardless of role?”
Tell an agent
List all people credited on reading list {readingListId}.
Show every contributor for list {readingListId}.
GET /api/ReadingList/next-chapter Find the next chapter in a reading list · Returns the next chapter within the reading list #
Ask an LLM
“What chapter comes next in my reading list?”
“Can I find the next unread chapter of a series in a list?”
Tell an agent
Find the next chapter in list {readingListId} after {currentChapterId}.
Get the next chapter of {currentChapterId} in reading list {readingListId}.
GET /api/ReadingList/prev-chapter Get the previous chapter in a reading list · Returns the prev chapter within the reading list #
Ask an LLM
“What chapter comes before the current one in my reading list?”
“Can I get the previous chapter of a book I'm reading?”
Tell an agent
Get the previous chapter in reading list {readingListId}.
Find the chapter before chapter {currentChapterId} in {readingListId}.
GET /api/ReadingList/name-exists Check whether a reading list name is taken · Checks if a reading list exists with the name #
Ask an LLM
“Is a reading list name already in use?”
“Can I check a reading list name before creating it?”
Tell an agent
Check if a reading list named {name} exists.
Tell me whether the name {name} is already taken for a reading list.
POST /api/ReadingList/promote-multiple Promote or un-promote several reading lists at once · Promote/UnPromote multiple reading lists in one go. #
Ask an LLM
“Can I mark several reading lists as promoted or un-promoted in one request?”
“How do I change the promoted status of multiple reading lists together?”
Tell an agent
Promote reading lists {readingListIds} to {promoted}.
Set the promoted status of {readingListIds} to {promoted}.
POST /api/ReadingList/delete-multiple Delete several reading lists at once · Delete multiple reading lists in one go #
Ask an LLM
“Can I delete multiple reading lists in a single request?”
“How do I remove several reading lists I no longer need?”
Tell an agent destructive · confirm first
Delete reading lists {readingListIds}.
Remove the reading lists {readingListIds} permanently.
GET /api/ReadingList/info Get random information about a reading list · Returns random information about a Reading List #
Ask an LLM
“Can I get some random information about a reading list?”
“What does the info endpoint return for a reading list?”
Tell an agent
Get random information about reading list {readingListId}.
Show a random fact about reading list {readingListId}.
POST /api/ReadingList/export-as-cbl Export a reading list to Comic Book Library format · Export a Reading List to CBL format #
Ask an LLM
“Can I export my reading list as a CBL file?”
“Is there an option to export a reading list as a comic book library file?”
Tell an agent
Export reading list {readingListId} as CBL.
Export reading list {readingListId} as CBL version {asV2}.
POST /api/ReadingList/regenerate-cover Regenerate a reading list cover image · Regenerates the cover image for a reading list, you must own the given reading… #
Ask an LLM
“Can I force Kavita to redraw the cover image for a reading list?”
“How do I refresh a reading list's cover art?”
Tell an agent
Regenerate the cover for reading list {readingListId}.
Rebuild the cover image of reading list {readingListId}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kavita:kavita-reading-list-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kavita-reading-list-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kavita Reading List API
  description: Kavita provides a set of APIs authenticated via an Auth Key passed in the `x-api-key` header. Generate an Auth Key under User Settings → Manage Auth Keys, paste it into the Authorize panel, and all Try It requests will include it. Assume all fields of a payload are required unless marked optional. Built against v0.9.1.15
  license:
    name: GPL-3.0
    url: https://github.com/Kareadita/Kavita/blob/develop/LICENSE
  version: 0.9.1.15
servers:
- url: '{protocol}://{hostpath}'
  variables:
    protocol:
      default: http
      enum:
      - http
      - https
    hostpath:
      default: localhost:5000
security:
- AuthKey: []
tags:


# --- truncated at 32 KB (42 KB total) ---
# Full source: https://artifacts.apis.io/kavita/openapi/kavita-reading-list-api-openapi.yml