RAGaaS Logo

Authentication

RAGaaS uses API keys to authenticate requests.

API Keys

Get your API key from the RAGaaS Dashboard. Include it in the Authorization header for all API requests:

Authorization Header

Authorization: Bearer your_api_key

Keep your API key secure and never expose it in client-side code or public repositories.

Making Requests

Example of an authenticated request:

curl -X GET "https://api.ragaas.dev/v1/ingest-job-runs/ijr_abc123?namespaceId=ns_abc123" \
  -H "Authorization: Bearer $RAGAAS_API_KEY"

Error Responses

Status CodeDescription
401Invalid or missing API key
403Valid key but insufficient permissions
429Rate limit exceeded

Rate Limits

The API has the following rate limits:

PlanRate Limit
Pilot~50 requests per minute
Pro~200 requests per minute
Team~500 requests per minute
EnterpriseCustom limits

Rate limit headers are included in all responses:

Response Headers

X-RateLimit-Limit: 200       # Your current rate limit
X-RateLimit-Remaining: 199   # Requests remaining
X-RateLimit-Reset: 1640995200 # Timestamp when limit resets