API Reference
Authentication

Authentication

All Aila API requests require Bearer token authentication via an organization API key.


Generating an API Key

  1. Navigate to Settings > Connections in the web app.
  2. Scroll to API Keys.
  3. Click Generate API Key.
  4. Enter a descriptive key name (e.g., Production Backend, Staging Pipeline).
  5. 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 CodeReasonResolution
401 UnauthorizedMissing or invalid API key.Check key string in header.
403 ForbiddenKey lacks permission for resource.Verify user role.