Pages
tinytales_pages books:write
Add a page, change captions, reorder, set the cover, or retry a failed page. Actions: add, update_caption, reorder, set_cover, retry.
Actions: add, update_caption, reorder, set_cover, retry.
01Access
The signed-in customer must have approved books: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 tinytales_delete, 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 call can create another record.
03Input
Which action to run: add, update_caption, reorder, set_cover, retry.
Book id from tinytales_books action list or tinytales_books_write action create.
Page id for update_caption, set_cover, or retry.
Existing image id for add, from tinytales_images action list.
New caption for update_caption. An empty string clears it.
Comma-separated page ids in the new order for reorder. Include every page.
For set_cover: when true (default), move this page to page one.
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 action to call.
05Errors
- Book not found
- Page not found
- Image not found
- Generation is temporarily unavailable. Try again later.
06Example request
{
"action": "update_caption",
"book_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"page_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"caption": "The canoe"
}07Example response
{
"ok": true,
"summary": "Updated the page caption."
}