Skip to main content

hardcover_update_reading_status

Update a book's status, progress, or rating in Hardcover.

Parameters

ParameterTypeRequiredDescription
book_idstringYesHardcover book ID (from hardcover_get_my_library or search)
statusstringYesNew status: reading, read, want-to-read, dnf
progressintNoReading progress 0-100 (percentage)
ratingfloatNoRating 0-5 (half-star increments)

Examples

{"book_id": "123", "status": "reading", "progress": 50}
{"book_id": "123", "status": "read", "rating": 4.5}
{"book_id": "456", "status": "dnf", "progress": 20}

Notes

  • book_id is obtained from hardcover_get_my_library or booklife_find_book_everywhere
  • Progress is only meaningful for reading status
  • Rating persists across status changes