Kavita Collection API

APIs for Collections

GitHub OpenAPI

Operations 12

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/Collection List my collection tags · Returns all Collection tags for a given User #
Ask an LLM
“What collection tags have I created in Kavita?”
“Can I list only my own collections and skip promoted ones?”
Tell an agent
List all my collection tags.
Show my collections sorted by last modified: {sortByLastModified}.
DELETE /api/Collection Remove a collection tag · Removes the collection tag from the user #
Ask an LLM
“How do I delete a collection tag I no longer use?”
“Can I remove a single collection tag by its ID?”
Tell an agent destructive · confirm first
Delete collection tag {tagId}.
Remove the collection tag {tagId} from my library.
GET /api/Collection/single Get one collection tag · Returns a single Collection tag by Id for a given user #
Ask an LLM
“What title and summary does one collection tag have?”
“Can I fetch a single collection by its ID?”
Tell an agent
Get collection tag {collectionId}.
Show the details of collection {collectionId}.
GET /api/Collection/all-series Find collections a series belongs to · Returns all collections that contain the Series for the user with the option to… #
Ask an LLM
“Which collections contain a particular series?”
“Can I list every collection a series is in?”
Tell an agent
Find all collections that contain series {seriesId}.
List collections for series {seriesId}, owned only {ownedOnly}.
GET /api/Collection/name-exists Check if a collection name is taken · Checks if a collection exists with the name #
Ask an LLM
“Is a collection name already in use?”
“Can I check whether a collection with a given title exists?”
Tell an agent
Check if a collection named {name} exists.
Tell me whether the collection title {name} is already taken.
POST /api/Collection/update Rename or reconfigure a collection tag · Updates an existing tag with a new title, promotion status, and summary. #
Ask an LLM
“How do I rename an existing collection tag?”
“Can I change a collection's promotion status or age rating?”
Tell an agent
Rename collection {id} to {title}.
Set collection {id} promoted to {promoted}, summary {summary}, age rating {ageRating}.
POST /api/Collection/promote-multiple Promote or un-promote several collections · Promote/UnPromote multiple collections in one go. #
Ask an LLM
“Can I promote a batch of collections at once?”
“How do I un-promote several collections in one request?”
Tell an agent
Set promoted to {promoted} for collections {collectionIds}.
Promote collections {collectionIds} together.
POST /api/Collection/delete-multiple Delete several collections at once · Delete multiple collections in one go #
Ask an LLM
“Can I delete multiple collections in one call?”
“How do I remove a batch of collection tags?”
Tell an agent destructive · confirm first
Delete collections {collectionIds}.
Remove the collection tags {collectionIds} in one request.
POST /api/Collection/update-for-series Add series to a collection · Adds multiple series to a collection. If tag id is 0, this will create a new tag #
Ask an LLM
“How do I add several series to a collection?”
“Can I create a new collection tag and add series to it in one call?”
Tell an agent
Add series {seriesIds} to collection {collectionTagId}.
Create collection {collectionTagTitle} and add series {seriesIds}.
POST /api/Collection/update-series Update series summaries for a tag · For a given tag, update the summary if summary has changed and remove a set of… #
Ask an LLM
“Can I update the summary of several series under one tag at once?”
“Is it possible to remove a set of series from a tag?”
Tell an agent
Update the series summaries for tag {tag}.
Remove series {ids} from tag {tag} and update the summary.
GET /api/Collection/mal-stacks List MAL stacks in my library · For the authenticated user, if they have an active Kavita+ subscription and a… #
Ask an LLM
“What MAL stacks have I imported into Kavita?”
“Can I see the manga stacks from MyAnimeList?”
Tell an agent
List my MAL stacks.
Show the manga stacks imported from MyAnimeList.
POST /api/Collection/import-stack Import a MAL stack into Kavita · Imports a MAL Stack into Kavita #
Ask an LLM
“How do I import a MyAnimeList stack into Kavita?”
“Can I add a MAL stack with its author and series count?”
Tell an agent
Import MAL stack {title} from {url} with author {author}, {seriesCount} series and restack count {restackCount}.
Import MAL stack {title} (stack {stackId}) from {url} by {author}, {seriesCount} series, {restackCount} restacks.

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-collection-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-collection-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kavita Collection 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:
- name: Collection
  description: APIs for Collections
paths:
  /api/Collection:
    get:
      tags:
      - Collection
      summary: Returns all Collection tags for a given User
      parameters:
      - name: ownedOnly
        in: query
        description: Exclude Promoted
        schema:
          type: boolean
          default: false
      - name: sortByLastModified
        in: query
        description: Order by Last Modified rather than on Title
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AppUserCollectionDto'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AppUserCollectionDto'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AppUserCollectionDto'
      operationId: getApiCollection
      x-operation-id-source: derived
    delete:
      tags:
      - Collection
      summary: Removes the collection tag from the user
      parameters:
      - name: tagId
        in: query
        description: ''
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK
      operationId: deleteApiCollection
      x-operation-id-source: derived
  /api/Collection/single:
    get:
      tags:
      - Collection
      summary: Returns a single Collection tag by Id for a given user
      parameters:
      - name: collectionId
        in: query
        description: ''
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/AppUserCollectionDto'
            application/json:
              schema:
                $ref: '#/components/schemas/AppUserCollectionDto'
            text/json:
              schema:
                $ref: '#/components/schemas/AppUserCollectionDto'
      operationId: getApiCollectionSingle
      x-operation-id-source: derived
  /api/Collection/all-series:
    get:
      tags:
      - Collection
      summary: Returns all collections that contain the Series for the user with the option to…
      parameters:
      - name: seriesId
        in: query
        description: ''
        schema:
          type: integer
          format: int32
      - name: ownedOnly
        in: query
        description: ''
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AppUserCollectionDto'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AppUserCollectionDto'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AppUserCollectionDto'
      operationId: getApiCollectionAllSeries
      x-operation-id-source: derived
  /api/Collection/name-exists:
    get:
      tags:
      - Collection
      summary: Checks if a collection exists with the name
      parameters:
      - name: name
        in: query
        description: If empty or null, will return true as that is invalid
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: boolean
            application/json:
              schema:
                type: boolean
            text/json:
              schema:
                type: boolean
      operationId: getApiCollectionNameExists
      x-operation-id-source: derived
  /api/Collection/update:
    post:
      tags:
      - Collection
      summary: Updates an existing tag with a new title, promotion status, and summary.
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppUserCollectionDto'
          text/json:
            schema:
              $ref: '#/components/schemas/AppUserCollectionDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/AppUserCollectionDto'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/AppUserCollectionDto'
            application/json:
              schema:
                $ref: '#/components/schemas/AppUserCollectionDto'
            text/json:
              schema:
                $ref: '#/components/schemas/AppUserCollectionDto'
      operationId: postApiCollectionUpdate
      x-operation-id-source: derived
  /api/Collection/promote-multiple:
    post:
      tags:
      - Collection
      summary: Promote/UnPromote multiple collections in one go.
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromoteCollectionsDto'
          text/json:
            schema:
              $ref: '#/components/schemas/PromoteCollectionsDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/PromoteCollectionsDto'
      responses:
        '200':
          description: OK
      operationId: postApiCollectionPromoteMultiple
      x-operation-id-source: derived
  /api/Collection/delete-multiple:
    post:
      tags:
      - Collection
      summary: Delete multiple collections in one go
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteCollectionsDto'
          text/json:
            schema:
              $ref: '#/components/schemas/DeleteCollectionsDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/DeleteCollectionsDto'
      responses:
        '200':
          description: OK
      operationId: postApiCollectionDeleteMultiple
      x-operation-id-source: derived
  /api/Collection/update-for-series:
    post:
      tags:
      - Collection
      summary: Adds multiple series to a collection. If tag id is 0, this will create a new tag
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CollectionTagBulkAddDto'
          text/json:
            schema:
              $ref: '#/components/schemas/CollectionTagBulkAddDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/CollectionTagBulkAddDto'
      responses:
        '200':
          description: OK
      operationId: postApiCollectionUpdateForSeries
      x-operation-id-source: derived
  /api/Collection/update-series:
    post:
      tags:
      - Collection
      summary: For a given tag, update the summary if summary has changed and remove a set of…
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSeriesForTagDto'
          text/json:
            schema:
              $ref: '#/components/schemas/UpdateSeriesForTagDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateSeriesForTagDto'
      responses:
        '200':
          description: OK
      operationId: postApiCollectionUpdateSeries
      x-operation-id-source: derived
  /api/Collection/mal-stacks:
    get:
      tags:
      - Collection
      summary: For the authenticated user, if they have an active Kavita+ subscription and a…
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MalStackDto'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MalStackDto'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MalStackDto'
      operationId: getApiCollectionMalStacks
      x-operation-id-source: derived
  /api/Collection/import-stack:
    post:
      tags:
      - Collection
      summary: Imports a MAL Stack into Kavita
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MalStackDto'
          text/json:
            schema:
              $ref: '#/components/schemas/MalStackDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/MalStackDto'
      responses:
        '200':
          description: OK
      operationId: postApiCollectionImportStack
      x-operation-id-source: derived
components:
  schemas:
    UpdateSeriesForTagDto:
      type: object
      properties:
        tag:
          $ref: '#/components/schemas/AppUserCollectionDto'
        seriesIdsToRemove:
          type:
          - array
          - 'null'
          items:
            type: integer
            format: int32
      additionalProperties: false
    AppUserCollectionDto:
      type: object
      properties:
        id:
          type: integer
          format: int32
        title:
          type:
          - string
          - 'null'
        summary:
          type:
          - string
          - 'null'
        promoted:
          type: boolean
        ageRating:
          $ref: '#/components/schemas/AgeRating'
        coverImage:
          type:
          - string
          - 'null'
        primaryColor:
          type:
          - string
          - 'null'
        secondaryColor:
          type:
          - string
          - 'null'
        coverImageLocked:
          type: boolean
        itemCount:
          type: integer
          format: int32
        owner:
          type:
          - string
          - 'null'
        lastSyncUtc:
          type: string
          format: date-time
        source:
          $ref: '#/components/schemas/ScrobbleProvider'
        sourceUrl:
          type:
          - string
          - 'null'
        totalSourceCount:
          type: integer
          format: int32
        missingSeriesFromSource:
          type:
          - string
          - 'null'
      additionalProperties: false
    ScrobbleProvider:
      enum:
      - 0
      - 1
      - 2
      - 4
      - 5
      - 6
      type: integer
      description: 'Members:

        - `0` — Kavita

        - `1` — AniList

        - `2` — Mal

        - `4` — Cbr

        - `5` — Hardcover

        - `6` — MangaBaka'
      format: int32
      x-enum-varnames:
      - Kavita
      - AniList
      - Mal
      - Cbr
      - Hardcover
      - MangaBaka
      x-enum-descriptions:
      - Kavita
      - AniList
      - Mal
      - Cbr
      - Hardcover
      - MangaBaka
    DeleteCollectionsDto:
      required:
      - collectionIds
      type: object
      properties:
        collectionIds:
          type: array
          items:
            type: integer
            format: int32
      additionalProperties: false
    AgeRating:
      enum:
      - 0
      - 1
      - 2
      - 3
      - 4
      - 5
      - 6
      - 7
      - 8
      - 9
      - 10
      - 11
      - 12
      - 13
      - 14
      - -1
      type: integer
      description: 'Members:

        - `0` — Unknown

        - `1` — Rating Pending (RatingPending)

        - `2` — Early Childhood (EarlyChildhood)

        - `3` — Everyone

        - `4` — G

        - `5` — Everyone 10+ (Everyone10Plus)

        - `6` — PG

        - `7` — Kids to Adults (KidsToAdults)

        - `8` — Teen

        - `9` — MA15+ (Mature15Plus)

        - `10` — Mature 17+ (Mature17Plus)

        - `11` — M (Mature)

        - `12` — R18+ (R18Plus)

        - `13` — Adults Only 18+ (AdultsOnly)

        - `14` — X18+ (X18Plus)

        - `-1` — Not Applicable (NotApplicable)'
      format: int32
      x-enum-varnames:
      - Unknown
      - RatingPending
      - EarlyChildhood
      - Everyone
      - G
      - Everyone10Plus
      - PG
      - KidsToAdults
      - Teen
      - Mature15Plus
      - Mature17Plus
      - Mature
      - R18Plus
      - AdultsOnly
      - X18Plus
      - NotApplicable
      x-enum-descriptions:
      - Unknown
      - Rating Pending
      - Early Childhood
      - Everyone
      - G
      - Everyone 10+
      - PG
      - Kids to Adults
      - Teen
      - MA15+
      - Mature 17+
      - M
      - R18+
      - Adults Only 18+
      - X18+
      - Not Applicable
    PromoteCollectionsDto:
      type: object
      properties:
        collectionIds:
          type:
          - array
          - 'null'
          items:
            type: integer
            format: int32
        promoted:
          type: boolean
      additionalProperties: false
    MalStackDto:
      required:
      - author
      - restackCount
      - seriesCount
      - stackId
      - title
      - url
      type: object
      properties:
        title:
          type:
          - string
          - 'null'
        stackId:
          type: integer
          format: int64
        url:
          type:
          - string
          - 'null'
        author:
          type:
          - string
          - 'null'
        seriesCount:
          type: integer
          format: int32
        restackCount:
          type: integer
          format: int32
        existingId:
          type: integer
          format: int32
      additionalProperties: false
    CollectionTagBulkAddDto:
      type: object
      properties:
        collectionTagId:
          type: integer
          format: int32
        collectionTagTitle:
          type:
          - string
          - 'null'
        seriesIds:
          type:
          - array
          - 'null'
          items:
            type: integer
            format: int32
      additionalProperties: false
  securitySchemes:
    AuthKey:
      type: apiKey
      description: Auth Key authentication. Enter your Auth key from your user settings
      name: x-api-key
      in: header