Authentication
All Aila API requests require Bearer token authentication via an organization API key.
Generating an API Key
- Navigate to Settings > Connections in the web app.
- Scroll to API Keys.
- Click Generate API Key.
- Enter a descriptive key name (e.g.,
Production Backend,Staging Pipeline). - Copy the generated key. Aila displays the full key string only once.
API Key Header Usage
Pass the key as a Bearer token in the Authorization header:
curl -X GET https://app.aila.fyi/api/v1/calls \
-H "Authorization: Bearer <YOUR_API_KEY>"Key Permissions and Revocation
- Permissions: API keys inherit the permissions of the creating user.
- Revocation: To revoke access immediately, click Revoke next to the key in Settings > Connections.
Error Status Codes
| Status Code | Reason | Resolution |
|---|---|---|
401 Unauthorized | Missing or invalid API key. | Check key string in header. |
403 Forbidden | Key lacks permission for resource. | Verify user role. |