API & SDK
Manage inboxes, connections, and activity programmatically
Base URL
https://api-test.airbox.fyi
Interactive OpenAPI docs (Swagger) are served at https://api-test.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.
Quick example
curl -s https://api-test.airbox.fyi/inboxes \ -H "X-API-Key: YOUR_KEY" | jq
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
Inbound SendGrid parse and self-hosting