---
title: "Updates the Series"
method: POST
path: "/api/Series/update"
tags: ["Series"]
---

# Updates the Series

`POST /api/Series/update`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Series/update`
- Auth: API key in header `x-api-key`

## Request body

- UpdateSeriesDto
  - `id` integer
  - `name` string, nullable
  - `localizedName` string, nullable
  - `sortName` string, nullable
  - `coverImageLocked` boolean
  - `nameLocked` boolean
  - `sortNameLocked` boolean
  - `localizedNameLocked` boolean
  - `metadataProviderOverride` 2 | 3 | 4: Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup
  - `aniListId` integer, nullable
  - `malId` integer, nullable
  - `hardcoverId` integer, nullable
  - `metronId` integer, nullable
  - `comicVineId` string, nullable
  - `mangaBakaId` integer, nullable
  - `cbrId` integer, nullable

## Response `200`

OK

- SeriesDto
  - `id` integer
  - `name` string, nullable
  - `originalName` string, nullable
  - `localizedName` string, nullable
  - `sortName` string, nullable
  - `pages` integer
  - `coverImageLocked` boolean
  - `lastChapterAdded` string, date-time
  - `lastChapterAddedUtc` string, date-time
  - `userRating` number, float
  - `hasUserRated` boolean
  - `totalReads` integer
  - `pagesRead` integer
  - `latestReadDate` string, date-time
  - `format` 0 | 1 | 2 | 3 | 4: Members: - `0` — Image - `1` — Archive - `2` — Unknown - `3` — EPUB (Epub) - `4` — PDF (Pdf)
  - `created` string, date-time
  - `sortNameLocked` boolean
  - `localizedNameLocked` boolean
  - `nameLocked` boolean
  - `wordCount` integer
  - `libraryId` integer
  - `libraryName` string, nullable
  - `minHoursToRead` integer
  - `maxHoursToRead` integer
  - `avgHoursToRead` number, float
  - `folderPath` string, nullable
  - `lowestFolderPath` string, nullable
  - `lastFolderScanned` string, date-time
  - `dontMatch` boolean
  - `isBlacklisted` boolean
  - `isStandAlone` boolean
  - `metadataProviderOverride` 2 | 3 | 4: Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup
  - `coverImage` string, nullable
  - `primaryColor` string, nullable
  - `secondaryColor` string, nullable
  - `aniListId` integer
  - `malId` integer
  - `hardcoverId` integer
  - `metronId` integer
  - `comicVineId` string, nullable
  - `mangaBakaId` integer
  - `mangaBakaEditionId` string, nullable
  - `cbrId` integer

## Changes

- **2026-08-19** `8f6bc4f38f06`: 3 breaking, 6 info
  - the `mangaBakaId` request property format changed from `int64` to `int32` (media type: application/json)
  - the `mangaBakaId` request property format changed from `int64` to `int32` (media type: text/json)
  - the `mangaBakaId` request property format changed from `int64` to `int32` (media type: application/*+json)
  - added the new optional request property `metadataProviderOverride` (media type: application/json)
  - …5 more
- **2026-07-23** `751a92d6effc`: 15 info
  - added the new optional request property `name` (media type: application/json)
  - added the new optional request property `name` (media type: text/json)
  - added the new optional request property `name` (media type: application/*+json)
  - added the new optional request property `nameLocked` (media type: application/json)
  - …11 more
- **2026-05-19** `f23d18415096`: 6 info
  - added the new optional request property `cbrId` (media type: application/json)
  - added the new optional request property `cbrId` (media type: text/json)
  - added the new optional request property `cbrId` (media type: application/*+json)
  - added the optional property `cbrId` to the response with the `200` status (media type: text/plain)
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Series/update/post.md)

---

[API](https://skmtc.dev/kareadita/apis/kavita.md) - [All operations](https://skmtc.dev/kareadita/apis/kavita/llms.txt) - [OpenAPI document](https://skmtc.dev/kareadita/apis/kavita/revisions/d266465eeb67?raw)