Start Here
Authentication
Use backend-only Bearer API key authentication issued per tenant.
API Keys
Math AI currently issues API keys from the admin side. Keys are intended for secure backend use only.
Send the key in Authorization: Bearer <api_key>
Do not expose the key in browser JavaScript, mobile apps, or public clients
Rotate keys on team changes, suspected leakage, or scheduled security intervals
Tenant Permissions
read: allows subject and instruction read endpoints
chat: allows chat creation and message sending
analytics: reserved for usage analytics endpoints
Required Request Headers
Standard Headershttp
Authorization: Bearer <your_api_key>
Content-Type: application/json
Idempotency-Key: <unique_value_for_post_requests>