Launch price: $25 $15 a book, shipped free
TinyTales
How it works What you get Pricing For agents Sign in
pick a crayon
Start a book

Orders

tinytales_orders orders:read

List print orders or load one order, including tracking when the printer has provided it. Actions: list, get.

Actions: list, get.


01Access

The signed-in customer must have approved orders:read. Calls stay inside that account.

02Annotations

readOnlyHint
true

The tool only loads data that already belongs to the signed-in account.

destructiveHint
false

The change can be removed later with tinytales_delete, or it only adds data.

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
true

Repeating the same call does not stack a second effect.

03Input

action
string · required

Which action to run: list, get.

status
string

Optional order status filter for list.

exclude_pending
boolean

When true, omit orders that have not been paid.

limit
integer

Page size from 1 to 50. Defaults to 20.

cursor
string

Opaque cursor from the previous page. Omit for the first page.

order_id
string

Order id from list, required for get.

response_format
string

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

04Output

ok
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.

has_more
boolean

True when another page exists.

next_cursor
string

Pass as cursor to fetch the next page.

total_count
integer

Total matching rows when the route can count them.

data
string

Order list or order JSON.

05Errors

06Example request

{
  "action": "list",
  "exclude_pending": true,
  "limit": 20
}

07Example response

{
  "ok": true,
  "summary": "1 paid order.",
  "total_count": 1,
  "has_more": false
}

All tools