---
title: "Given a valid path, will invoke either a Scan Series or Scan Library. If the folder does not exist within Kavita, the request will be ignored"
method: POST
path: "/api/Library/scan-folder"
tags: ["Library"]
---

# Given a valid path, will invoke either a Scan Series or Scan Library. If the folder does not exist within Kavita, the request will be ignored

`POST /api/Library/scan-folder`

## Request

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

## Request body

- ScanFolderDto
  - `apiKey` string, nullable
  - `folderPath` string, nullable
  - `abortOnNoSeriesMatch` boolean

## Response `200`

OK

## Changes

- **2026-01-04** `d871bfda2376`: 3 info
  - added the new optional request property `abortOnNoSeriesMatch` (media type: application/json)
  - added the new optional request property `abortOnNoSeriesMatch` (media type: text/json)
  - added the new optional request property `abortOnNoSeriesMatch` (media type: application/*+json)

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