API & SDK

Run AI on content, and manage inboxes, connections, and activity programmatically

Base URL

https://api.airbox.fyi

Interactive OpenAPI docs (Swagger) are served at https://api.airbox.fyi/docs.

Authentication

The dashboard uses a signed HTTP-only session cookie. The SDK and scripts use X-API-Key — mint a key in Dashboard → Settings (shown once).

See Authentication.

Run AI on content

The headline endpoint: POST /v1/messages runs an instruction plus content through one of your inboxes and returns the AI result — the programmatic version of forwarding an email. This is how you use Airbox inside Zapier, Make, n8n, Apify, or your own code.

curl -s https://api.airbox.fyi/v1/messages \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instruction": "Summarize in 3 bullets", "content": "…long text…"}'

Manage resources

curl -s https://api.airbox.fyi/inboxes \
  -H "X-API-Key: YOUR_KEY" | jq

Run AI (routing)

POST /v1/messages — run AI on content, get the result back

Authentication

Session cookie, API key rotation, login flows

Inboxes

Create, route, rotate, test, and delete addresses

Connections

LLM providers, MCP servers, Notion OAuth

Contexts

Standing instructions, knowledge, and custom commands

Messages

Activity log — status, results, usage

Webhooks

Signed events on message activity — with retries