Delete and revoke

tinytales_delete books:delete

Delete a book, page, or image; publish; rotate or revoke a share link; remove a collaborator. Actions: book, page, image, publish, rotate_share, revoke_share, remove_collaborator.

Actions: book, page, image, publish, rotate_share, revoke_share, remove_collaborator.

01Access

The signed-in customer must have approved books:delete. Calls stay inside that account.

02Annotations

readOnlyHint

false

The tool deletes records, publishes, or irrevocably changes share access.

destructiveHint

true

Deletes, publish, share rotation, share revoke, and collaborator removal cannot be undone from this tool.

openWorldHint

false

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.

idempotentHint

false

Repeating the call can create another record.

03Input

action

string · required

Which action to run: book, page, image, publish, rotate_share, revoke_share, remove_collaborator.

book_id

string

Book id for book, page, publish, rotate_share, revoke_share, or remove_collaborator.

page_id

string

Page id for page.

image_id

string

Image id for image.

user_id

string

Collaborator user id from tinytales_share action collaborators.

response_format

string

json returns structured data. markdown returns the same data as a short readable summary. Defaults to json.

04Output

boolean · required

True when the underlying TinyTales route accepted the call.

summary

string · required

One-line result for the model to read.

error

string

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
Collaborator not found
Book can only be published once it is ready.

06Example request

{
  "action": "page",
  "book_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "page_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
}

07Example response

{
  "ok": true,
  "summary": "Deleted the page."
}

All tools