CreateLibraryRequest

Create library request

allowedFormatsstring[]nullable

Allowed file formats (e.g., ["CBZ", "CBR", "EPUB"])

Example: ["CBZ","CBR","EPUB"]

bookConfig

Book strategy-specific configuration (JSON, mutable after creation)

bookStrategy object

oneOf

null

null

BookStrategy

string

Book naming strategy (mutable after creation) Options: filename, metadata_first, smart, series_name

Possible values: [filename, metadata_first, smart, series_name, custom]

defaultReadingDirectionstring | nullnullable

Default reading direction for books in this library (ltr, rtl, ttb or webtoon)

Example: ltr

descriptionstring | nullnullable

Optional description

Example: My comic book collection

excludedPatternsstring | nullnullable

Excluded path patterns (newline-separated, e.g., ".DS_Store\nThumbs.db")

Example: .DS_Store Thumbs.db

namestringrequired

Library name

Example: Comics

numberConfig

Number strategy-specific configuration (JSON, mutable after creation)

numberStrategy object

oneOf

null

null

NumberStrategy

string

Book number strategy (mutable after creation) Options: file_order, metadata, filename, smart

Possible values: [file_order, metadata, filename, smart]

pathstringrequired

Filesystem path to the library

Example: /media/comics

scanImmediatelyboolean

Scan immediately after creation (not stored in DB)

Example: true

scanningConfig object

oneOf

null

null

ScanningConfigDto

cronSchedulestring | nullnullable

Cron expression for scheduled scans (e.g., "0 */6 * * *")

Example: 0 */6 * * *

enabledbooleanrequired

Whether scheduled scanning is enabled

Example: true

purgeDeletedOnScanboolean

Purge soft-deleted books after completing a scan

Example: false

scanModestringrequired

Default scan mode for scheduled scans ("normal" or "deep")

Example: normal

scanOnStartboolean

Scan library when the application starts

Example: false

seriesConfig

Strategy-specific configuration (JSON, immutable after creation)

seriesStrategy object

oneOf

null

null

SeriesStrategy

string

Series detection strategy (immutable after creation) Options: series_volume, series_volume_chapter, flat, publisher_hierarchy, calibre, custom

Possible values: [series_volume, series_volume_chapter, flat, publisher_hierarchy, calibre, custom]

CreateLibraryRequest

{
  "allowedFormats": [
    "CBZ",
    "CBR",
    "EPUB"
  ],
  "bookStrategy": "null",
  "defaultReadingDirection": "ltr",
  "description": "My comic book collection",
  "excludedPatterns": ".DS_Store\nThumbs.db",
  "name": "Comics",
  "numberStrategy": "null",
  "path": "/media/comics",
  "scanImmediately": true,
  "scanningConfig": "null",
  "seriesStrategy": "null"
}