BulkPatchBookMetadataRequest

Bulk PATCH request for book metadata

Applies the same partial update to all specified books. Only provided fields will be updated. Absent fields are unchanged. Title, title_sort, number, summary, subtitle are excluded (too unique per item). Max 500 books per request.

authors object[]

Structured author information

Array [

namestringrequired

Author's name

Example: Andy Weir

roleBookAuthorRole (string)required

Role of this author

Possible values: [author, co_author, editor, translator, illustrator, contributor, writer, penciller, inker, colorist, letterer, cover_artist]

sortNamestring | nullnullable

Sort name for ordering (e.g., "Weir, Andy")

Example: Weir, Andy

]

blackAndWhiteboolean | nullnullable

Whether the book is in black and white

bookIdsstring<uuid>[]required

Book IDs to update (max 500)

bookTypestring | nullnullable

Book type (comic, manga, novel, etc.)

customMetadataobject | nullnullable

Custom JSON metadata (uses RFC 7386 JSON Merge Patch semantics)

editionstring | nullnullable

Edition (e.g., "Deluxe", "Omnibus")

genrestring | nullnullable

Genre (legacy single genre field)

imprintstring | nullnullable

Imprint (sub-publisher)

languageIsostring | nullnullable

Language ISO code

mangaboolean | nullnullable

Whether the book is manga format

originalTitlestring | nullnullable

Original title (if translated)

originalYearinteger,null<int32>nullable

Original publication year

publisherstring | nullnullable

Publisher name

translatorstring | nullnullable

Translator name

BulkPatchBookMetadataRequest

{
  "authors": "Unknown Type: array,null",
  "blackAndWhite": true,
  "bookIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "bookType": "string",
  "customMetadata": "Unknown Type: object,null",
  "edition": "string",
  "genre": "string",
  "imprint": "string",
  "languageIso": "string",
  "manga": true,
  "originalTitle": "string",
  "originalYear": 0,
  "publisher": "string",
  "translator": "string"
}