Set the book cover
tinytales_set_cover tinytales:write
Set any page as the book cover. By default the page is also moved to page one. The cover page id and number are returned on tinytales_get_book. Changing the cover invalidates preview approval.
01Access
The signed-in customer must have approved tinytales:write. Calls stay inside that account.
02Annotations
The tool creates or updates records in the signed-in account.
The change can be removed later with a delete tool, or it only adds data.
This tool only reads or changes the signed-in TinyTales account. It does not post to the public internet or to other people’s services.
Repeating the same call does not stack a second effect.
03Input
Book id returned by tinytales_list_books or tinytales_create_book.
Page id from tinytales_get_book.
When true (the default), reorder this page to page one. When false, keep the current order and only mark it as the cover.
json returns structured data. markdown returns the same data as a short readable summary. Defaults to json.
04Output
True when the underlying TinyTales route accepted the call.
One-line result for the model to read.
Present when ok is false. Names the failed state and the next tool to call.
05Errors
- Book not found
- Page not found
06Example request
{
"book_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"page_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"move_to_front": true
}
07Example response
{
"ok": true,
"summary": "Cover set to page 1."
}