Kavita Manage API

All things centered around Managing the Kavita instance, that isn't aligned with an entity

GitHub OpenAPI

Operations 2

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

POST /api/Manage/series-metadata Find series that match metadata · Returns a list of all Series that is Kavita+ applicable to metadata match and… #
Ask an LLM
“Which of my series have metadata matches?”
“Can I search series by match state?”
Tell an agent
Find series matching {searchTerm}.
Show series with match state {matchStateOption}.
GET /api/Manage/matched-series-counts Count matched series · Returns high level counts for matched series page #
Ask an LLM
“How many of my series have metadata matches?”
“What are the counts of matched, unmatched and errored series?”
Tell an agent
Show matched series counts.
Give me the number of series with metadata errors.

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-manage-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-manage-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kavita Manage 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: Manage
  description: All things centered around Managing the Kavita instance, that isn't aligned with an entity
paths:
  /api/Manage/series-metadata:
    post:
      tags:
      - Manage
      summary: Returns a list of all Series that is Kavita+ applicable to metadata match and…
      parameters:
      - name: PageNumber
        in: query
        schema:
          type: integer
          format: int32
      - name: PageSize
        in: query
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManageMatchFilterDto'
          text/json:
            schema:
              $ref: '#/components/schemas/ManageMatchFilterDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ManageMatchFilterDto'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ManageMatchSeriesDto'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ManageMatchSeriesDto'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ManageMatchSeriesDto'
      operationId: postApiManageSeriesMetadata
      x-operation-id-source: derived
  /api/Manage/matched-series-counts:
    get:
      tags:
      - Manage
      summary: Returns high level counts for matched series page
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/MatchedExternalSeriesCountDto'
            application/json:
              schema:
                $ref: '#/components/schemas/MatchedExternalSeriesCountDto'
            text/json:
              schema:
                $ref: '#/components/schemas/MatchedExternalSeriesCountDto'
      operationId: getApiManageMatchedSeriesCounts
      x-operation-id-source: derived
components:
  schemas:
    MangaFormat:
      enum:
      - 0
      - 1
      - 2
      - 3
      - 4
      type: integer
      description: 'Members:

        - `0` — Image

        - `1` — Archive

        - `2` — Unknown

        - `3` — EPUB (Epub)

        - `4` — PDF (Pdf)'
      format: int32
      x-enum-varnames:
      - Image
      - Archive
      - Unknown
      - Epub
      - Pdf
      x-enum-descriptions:
      - Image
      - Archive
      - Unknown
      - EPUB
      - PDF
    ManageMatchFilterDto:
      type: object
      properties:
        matchStateOption:
          $ref: '#/components/schemas/MatchStateOption'
        libraryType:
          type: integer
          format: int32
        searchTerm:
          type:
          - string
          - 'null'
      additionalProperties: false
    MetadataProvider:
      enum:
      - 2
      - 3
      - 4
      type: integer
      description: 'Members:

        - `2` — Hardcover

        - `3` — Mangabaka

        - `4` — ComicBookRoundup'
      format: int32
      x-enum-varnames:
      - Hardcover
      - Mangabaka
      - ComicBookRoundup
      x-enum-descriptions:
      - Hardcover
      - Mangabaka
      - ComicBookRoundup
    MatchStateOption:
      enum:
      - 0
      - 1
      - 2
      - 3
      - 4
      type: integer
      description: 'Members:

        - `0` — All

        - `1` — Matched

        - `2` — NotMatched

        - `3` — Error

        - `4` — DontMatch'
      format: int32
      x-enum-varnames:
      - All
      - Matched
      - NotMatched
      - Error
      - DontMatch
      x-enum-descriptions:
      - All
      - Matched
      - NotMatched
      - Error
      - DontMatch
    SeriesDto:
      type: object
      properties:
        id:
          type: integer
          format: int32
        name:
          type:
          - string
          - 'null'
        originalName:
          type:
          - string
          - 'null'
        localizedName:
          type:
          - string
          - 'null'
        sortName:
          type:
          - string
          - 'null'
        pages:
          type: integer
          format: int32
        coverImageLocked:
          type: boolean
        lastChapterAdded:
          type: string
          format: date-time
        lastChapterAddedUtc:
          type: string
          format: date-time
        userRating:
          type: number
          format: float
        hasUserRated:
          type: boolean
        totalReads:
          type: integer
          format: int32
        pagesRead:
          type: integer
          format: int32
        latestReadDate:
          type: string
          format: date-time
        format:
          $ref: '#/components/schemas/MangaFormat'
        created:
          type: string
          format: date-time
        sortNameLocked:
          type: boolean
        localizedNameLocked:
          type: boolean
        nameLocked:
          type: boolean
        wordCount:
          type: integer
          format: int64
        libraryId:
          type: integer
          format: int32
        libraryName:
          type:
          - string
          - 'null'
        minHoursToRead:
          type: integer
          format: int32
        maxHoursToRead:
          type: integer
          format: int32
        avgHoursToRead:
          type: number
          format: float
        folderPath:
          type:
          - string
          - 'null'
        lowestFolderPath:
          type:
          - string
          - 'null'
        lastFolderScanned:
          type: string
          format: date-time
        dontMatch:
          type: boolean
        isBlacklisted:
          type: boolean
        isStandAlone:
          type: boolean
        metadataProviderOverride:
          $ref: '#/components/schemas/MetadataProvider'
        coverImage:
          type:
          - string
          - 'null'
        primaryColor:
          type:
          - string
          - 'null'
        secondaryColor:
          type:
          - string
          - 'null'
        aniListId:
          type: integer
          format: int32
        malId:
          type: integer
          format: int64
        hardcoverId:
          type: integer
          format: int32
        metronId:
          type: integer
          format: int64
        comicVineId:
          type:
          - string
          - 'null'
        mangaBakaId:
          type: integer
          format: int32
        mangaBakaEditionId:
          type:
          - string
          - 'null'
        cbrId:
          type: integer
          format: int32
      additionalProperties: false
    ManageMatchSeriesDto:
      type: object
      properties:
        series:
          $ref: '#/components/schemas/SeriesDto'
        isMatched:
          type: boolean
        validUntilUtc:
          type: string
          format: date-time
      additionalProperties: false
    MatchedExternalSeriesCountDto:
      type: object
      properties:
        totalCount:
          type: integer
          format: int32
        dontMatchCount:
          type: integer
          format: int32
        notMatchedCount:
          type: integer
          format: int32
        erroredCount:
          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