Curation profile
tinytales_profile profile:write
Save optional photo-curation notes and buyer defaults; omit a field to leave it unchanged. Action: update. Read the profile with tinytales_account action profile.
Actions: update.
01Access
The signed-in customer must have approved profile: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 same call does not stack a second effect.
03Input
Which action to run: update.
Free-text notes: who the books are for, style, what to skip.
JSON array of {ref, decision: picked|skipped, reason} that replaces the stored list.
Photo filename, Google media id, or other stable ref to upsert.
picked or skipped. Required when photo_ref is set.
Why this photo was picked or skipped.
JSON array of {name, age?}. Names are required; ages are optional. Keep kid data minimal.
How often to make a book: monthly, occasions, or on_demand.
google_photos_picker (human picks in TinyTales) or attach_in_chat.
Default printed copies for checkout when quantity is omitted. 1 means one shared copy.
Optional JSON shipping address to echo on the response. When omitted, uses the curation profile shipping address if one was saved. Polar still collects the paid address in the browser.
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
- photo_ref, decision (picked or skipped), and optional reason are required to add an entry.
06Example request
{
"action": "update",
"photo_ref": "lake.jpg",
"decision": "picked",
"reason": "Clear faces, good for a canoe page",
"default_quantity": 1
}07Example response
{
"ok": true,
"summary": "Saved the curation profile."
}