API reference

Every page in this reference is generated from Dairo's OpenAPI spec, so it always matches the API that is actually deployed.

Base URL

https://api.dairo.app

Every request carries an API key as a bearer token. Keys are scoped, so a key can only do what you granted it.

curl https://api.dairo.app/v1/inboxes \
  -H "Authorization: Bearer $DAIRO_API_KEY"

See API keys & authentication for how to create a key, and Scopes for what each one can reach.

How the API changes, and what counts as breaking.

Retry a send safely without delivering it twice.

Cursor your way through long collections.

The error envelope, and what each code means.