Edit a Grimmory book
update_bookEdit a book's title, authors, series details, categories, and field locks by hand; preview changes first, then confirm to apply so locked fields stay protected.
Instructions
Edits one Grimmory book by hand: title, authors, series, series number, categories (tags) and field locks. A locked field is refused unless the same call unlocks it, and Grimmory may rewrite the book file and rename it. Film, series or artist: update_media. From a provider: fix_metadata. Previews first; confirm to apply. Field reference: arr://docs/update_book.
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": {
"id": "<id>"
},
"name": "update_book"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The book's id: `acquisition.id` on a get_library record, as 58 or grimmory:58. | |
| tags | No | Its categories: free text that need not exist yet, replacing the set. [] clears them. | |
| title | No | The new title. | |
| series | No | The series name. "" clears it. | |
| authors | No | The authors; replaces the list. | |
| confirm | No | The token from this tool's preview; pass it back to apply. | |
| dry_run | No | Preview only, no token issued: for "what if" questions, not the first step of a change. | |
| instance | No | Which instance (e.g. "4k") when several of this service exist. Omit it when there is one. | |
| lock_fields | No | Fields to lock after writing, so a metadata refresh leaves them alone. | |
| series_number | No | The book's number in its series. | |
| unlock_fields | No | Fields to unlock before writing. A locked field is refused unless this call unlocks it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| noop | Yes | ||
| tier | Yes | ||
| tool | Yes | ||
| target | Yes | ||
| applied | Yes | ||
| dry_run | Yes | ||
| effects | Yes | ||
| service | Yes | ||
| summary | Yes | ||
| operation | Yes | ||
| permission | Yes |