Share write
tinytales_share_write books:write
Create or return a collaborator invite link, or join a book from a token. Actions: create, join. Preview first with tinytales_share action preview_join.
Actions: create, join.
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 same call does not stack a second effect.
03Input
Which action to run: create, join.
Book id for create.
Invite token from the share URL for join.
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
- Invite not found
06Example request
{
"action": "create",
"book_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}07Example response
{
"ok": true,
"summary": "Share link is ready."
}