---
title: "Updates an existing Library with new name, folders, and/or type."
method: POST
path: "/api/Library/update"
tags: ["Library"]
---

# Updates an existing Library with new name, folders, and/or type.

`POST /api/Library/update`

## Request

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

Any folder or type change will invoke a scan.

## Request body

- UpdateLibraryDto
  - `id` integer, required
  - `name` string, required
  - `type` 0 | 1 | 2 | 3 | 4 | 5, required: Members: - `0` — Manga - `1` — Comic (Flexible) (Comic) - `2` — Book - `3` — Image - `4` — Light Novel (LightNovel) - `5` — Comic (ComicVine)
  - `folders` string[], required
  - `folderWatchMode` 0 | 1 | 2 | 3: Members: - `0` — Off - `1` — Automatic - `2` — File Watcher (FileWatcher) - `3` — Polling
  - `includeInDashboard` boolean, required
  - `includeInSearch` boolean, required
  - `manageCollections` boolean, required
  - `manageReadingLists` boolean, required
  - `allowScrobbling` boolean, required
  - `allowMetadataMatching` boolean, required
  - `enableMetadata` boolean, required
  - `removePrefixForSortName` boolean, required
  - `inheritWebLinksFromFirstChapter` boolean, required
  - `defaultLanguage` string, nullable
  - `metadataProvider` 2 | 3 | 4: Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup
  - `fileGroupTypes` FileTypeGroup[], required
  - `excludePatterns` string[], required

## Response `200`

OK

## Changes

- **2026-10-22** `7de671750636`: 3 warning, 3 info
  - removed the request property `folderWatching` (media type: application/json)
  - removed the request property `folderWatching` (media type: text/json)
  - removed the request property `folderWatching` (media type: application/*+json)
  - added the new optional request property `folderWatchMode` (media type: application/json)
  - …2 more
- **2026-07-02** `72a1166b481f`: 3 info
  - added the new optional request property `metadataProvider` (media type: application/json)
  - added the new optional request property `metadataProvider` (media type: text/json)
  - added the new optional request property `metadataProvider` (media type: application/*+json)
- **2025-11-01** `6cabddef7e29`: 3 info
  - added the new optional request property `defaultLanguage` (media type: application/json)
  - added the new optional request property `defaultLanguage` (media type: text/json)
  - added the new optional request property `defaultLanguage` (media type: application/*+json)
- **2025-10-25** `07751d5dca44`: 3 breaking
  - added the new required request property `inheritWebLinksFromFirstChapter` (media type: application/json)
  - added the new required request property `inheritWebLinksFromFirstChapter` (media type: text/json)
  - added the new required request property `inheritWebLinksFromFirstChapter` (media type: application/*+json)
- …earlier changes not shown

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Library/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)