Skip to main content

WriteCounts

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. Includes stranded, so inserted + reattached + skipped still totals every row in the file.

Possible values: >= 0

strandedinteger<int32>required

Skipped because the row sits on a book that is still live in another library, which is not the same thing as a harmless re-import: the reading history stays behind while the progress moves. Reattaching it would strip a library the reader may still be using, so the import reports it instead of guessing.

Possible values: >= 0

WriteCounts
{
  "inserted": 0,
  "reattached": 0,
  "skipped": 0,
  "stranded": 0
}