Set the edition of a reading
update_book_editionSets which edition the reader's current reading of a book is in: one of the book's known editions (edition_id, from list_book_editions), or the edition with an ISBN (isbn: 10 or 13 digits, as printed on the book or read from a photo of its barcode). An ISBN ReadingRate does not know yet is looked up in Open Library and added as an edition of the book, checked to be this book, and other readers can then pick it too; give translation_id (from list_book_editions) when you know whose translation it is. The reading's page count follows the edition unless the reader typed their own, and its cover follows unless they chose one. Earlier readings keep their own edition. clear: true clears the edition. Use after list_book_editions, when the reader has said which edition they hold. To start a re-read first, use update_book_status with status "reading". Examples:
{"book_id": "", "edition_id": ""}
{"book_id": "", "isbn": "9780679772835", "translation_id": ""}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"book_id": "<book_id>"
},
"name": "update_book_edition"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isbn | No | The ISBN-10 or ISBN-13 of the reader's copy, instead of edition_id | |
| clear | No | true clears the reading's edition instead of setting one | |
| book_id | Yes | The book's ReadingRate id or slug, or its library entry id | |
| edition_id | No | A known edition's id from list_book_editions | |
| translation_id | No | With isbn: whose translation the copy is, a translation_id from list_book_editions |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| added | No | True when the ISBN was new to ReadingRate and its edition was added | |
| pages | No | The reading's page count after the change, when known | |
| edition | No | The edition now set: edition_id, publisher, year, pages, isbn_13, language, translators, cover_url; absent when cleared | |
| message | Yes | Human-readable result | |
| success | Yes | Whether the reading's edition was set | |
| reading_id | No | The reading whose edition was set | |
| reading_number | No | Which reading of the book it is (2 for a first re-read) |