Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Reliable replies

A successful send returns 202 Accepted with a message resource. This means the request was persisted for dispatch. Poll GET /api/v2/messages/{message_id} for its current delivery state.
Set Idempotency-Key to a unique value for each logical reply and reuse it when retrying that same reply. The same key and body return the original acceptance snapshot for 24 hours. A different body with that key returns a conflict. The polling endpoint returns current state; an idempotent replay does not refresh it.
StateMeaning
accepted, queuedWaiting for dispatch
sendingDispatch has begun
sentThe adapter reported a provider acknowledgement
delivered, readA corresponding receipt was recorded
failedA known failure prevented completion
unknownThe provider outcome cannot safely be determined
An unknown outcome is not permission to send again: the customer may already have received the message. Investigate before creating another logical send. Recovery requeues work that never started; it does not automatically repeat an uncertain provider request.
Message lists use insertion order with opaque cursor pagination. Imported historical timestamps can differ from that order. Cursors expire after 24 hours and are tied to the key, grants, and query context. Restart pagination if a cursor expires or access changes.