Getting started
Authentication
Every application request is authenticated with a Math API key in the Authorization header.
Send your key
Authorization: Bearer YOUR_API_KEYUse HTTPS and send the key in the header, never in a URL. The public documentation and OpenAPI specification do not require authentication.
curl --fail-with-body 'https://math-api.qmindlabs.ai/api/auth/session' \
-H "Authorization: Bearer $MATH_API_KEY"Issue, rotate, and revoke
Your administrator issues your initial key. A key with keys:manage can issue another key within its own role and scopes. Non-admins can issue keys only for themselves.
- Create a replacement key and save its secret immediately; it is returned once.
- Update your integration and verify a successful request.
- Revoke the old key. Revocation applies across the service.
Keys expire after 90 days by default, with a maximum of 365 days and 50 active keys per member.
POSTCreate an API keyDELETERevoke an API keyBrowser requests
The built-in tester omits cookies and calls this API host directly. Credentials are not stored in browser storage or sent through a third-party proxy. API-key requests with dashboard identity cookies are rejected. Navigating away or reloading requires entering your key again.
Troubleshooting access
| Status | What to check |
|---|---|
| 401 | Missing, malformed, expired, or revoked key. |
| 403 | Required scope, role, enabled membership, or request origin. |
| 404 | The resource may be unavailable or outside your assignments. |
Check roles and scopes and keep the x-request-id response header when reporting a problem.