Edit books
tinytales_books_write books:write
Create or update a draft coloring book, or queue generation. Actions: create, update, process. Add photos with tinytales_images_write.
Actions: create, update, process.
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: create, update, process.
Book id for update or process.
Book title, up to 60 characters. A default title is used when omitted on create.
Optional description, up to 500 characters.
Optional age group on create. Omit to use the account default.
Optional coloring style on create. Omit to use the style for the age group.
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
- Unauthorized
- Book not found
06Example request
{
"action": "create",
"title": "Sunday at the lake"
}07Example response
{
"ok": true,
"summary": "Created draft book “Sunday at the lake”."
}