All API requests (except /health) require authentication using an API key passed as a Bearer token in the Authorization header.
Get your API key
You can generate and manage your API keys from the AiQL Dashboard.
Making authenticated requests
Include your API key in the Authorization header with the Bearer scheme:
Replace YOUR_API_KEY with your actual API key from the dashboard.
All ingestion, query, and request endpoints require the AiQL-Workspace header containing your workspace ID. This tells the API which workspace to operate on.
Replace YOUR_WORKSPACE_ID with your workspace ID from the dashboard. You can get your workspace ID by listing workspaces or from the dashboard URL.
Example request
Here’s a complete example of creating a workspace:
Public endpoints
The /health endpoint does not require authentication and can be accessed without an API key:
Keep your API keys secure and never commit them to version control. If you believe your API key has been compromised, regenerate it immediately from the dashboard.
