update_library_book
Update an existing book's fields: change status, rating, review, dates, or current page. Setting rating/review publishes the entry.
Instructions
Update one or more fields of a book already in the library. Supply any subset — only the fields you pass change. Special behavior: current_page records a reading-progress log entry (this is what feeds get_reading_stats), and setting rating or review publishes that entry publicly. Returns the updated row; errors with 404 if the book is not in the library (add it first). When to use: change fields or log progress for a book ALREADY on a shelf. Add it first with add_book_to_library; remove it with remove_book_from_library. Requires SANSFICTION_TOKEN (a bearer token from https://sansfiction.com/docs/agents).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rating | No | Your rating on a 0–5 scale. Setting it publishes the entry. | |
| review | No | Free-text review. Setting it publishes the entry. | |
| status | No | Move the book to this shelf. | |
| book_id | Yes | Catalog book UUID of a book already on one of your shelves. | |
| started_at | No | Date you started reading, ISO 8601 date (YYYY-MM-DD). | |
| finished_at | No | Date you finished reading, ISO 8601 date (YYYY-MM-DD). | |
| current_page | No | Current page number. Passing this appends a reading-progress log entry used by get_reading_stats; it does not merely overwrite a field. |