Create a durable webhook inbox and get a public callback URL. External systems (or a human clicking a link) POST to that URL; capture the events later via GET /inboxes/{id}/events. Optional `label`/`metadata` describe the inbox's purpose and are returned on read/info/list. Priced by TTL tier (1d/7d/30d).
$0.003 – $0.01
02
GET
/inboxes
List the inboxes owned by the calling wallet, each with its id, label, and lifetime. Lets a stateless agent rediscover what each inbox is for after a restart. Returns up to 100 inboxes.
$0.001
03
GET
/inboxes/:id
Get an inbox label, metadata, lifetime, event count, and dropped count, without consuming events. Owner-scoped.
$0.001
04
GET
/inboxes/:id/events
Read events captured by an inbox. Query params: `since` (cursor from a previous response, returns only newer events) and `wait` (seconds to long-poll for the next event, max 30; returns as soon as one arrives). Echoes the inbox `label`/`metadata` for context. Owner-scoped: only the wallet that created the inbox can read it. Flat price regardless of wait.
$0.001
05
DELETE
/inboxes/:id
Delete an inbox and all its captured events. Owner-scoped.