ImportBookReport

The outcome for one book in the import file.

appliedbooleanrequired

Whether any writes were attempted for this book. False for every disposition except matched, and except stem_match when accept_stem_matches is off.

completions objectrequired

Insert/reattach/skip counts for an append-only table (completions or sessions) within one book.

insertedinteger<int32>required

Possible values: >= 0

reattachedinteger<int32>required

Adopted an orphaned row (book_id IS NULL) rather than inserting a new one.

Possible values: >= 0

skippedinteger<int32>required

Already present with the same book attached; re-importing is a no-op.

Possible values: >= 0

dispositionBookDispositionrequired

Why a book in the import file could not be resolved to exactly one book in its matched series.

Possible values: [matched, stem_match, ambiguous, unmatched, hash_mismatch]

file_namestringrequired

matched_book_id(string | null)<uuid>nullable

pathstringrequired

progressFieldOutcome

What happened to one scalar field write (progress or rating) under the active conflict policy.

Possible values: [inserted, updated, skipped]

sessions objectrequired

Insert/reattach/skip counts for an append-only table (completions or sessions) within one book.

insertedinteger<int32>required

Possible values: >= 0

reattachedinteger<int32>required

Adopted an orphaned row (book_id IS NULL) rather than inserting a new one.

Possible values: >= 0

skippedinteger<int32>required

Already present with the same book attached; re-importing is a no-op.

Possible values: >= 0

ImportBookReport

{
  "applied": true,
  "completions": {
    "inserted": 0,
    "reattached": 0,
    "skipped": 0
  },
  "disposition": "matched",
  "file_name": "string",
  "matched_book_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "path": "string",
  "progress": "inserted",
  "sessions": {
    "inserted": 0,
    "reattached": 0,
    "skipped": 0
  }
}