Authentication
Authentication
Learn how to authenticate and manage your API keys securely
The BrainUs API uses API keys to authenticate requests. API keys are unique identifiers that grant access to the API and track your usage against your plan limits.
Security First: Treat your API keys like passwords. Never expose them in client-side code, public repositories, or share them publicly.
Quick Example
curl -X POST "https://api.brainus.lk/api/v1/query" \
-H "X-API-Key: $BRAINUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "What is photosynthesis?", "store_id": "default"}'Getting Your API Key
- Sign up at developers.brainus.lk
- Subscribe to a plan - Go to Upgrade and subscribe to a Free or paid plan (no credit card required for Free plan)
- Navigate to Dashboard → API Keys
- Click "Create API Key"
- Copy your key immediately (you won't see it again!)
Subscription Required: You must have an active developer subscription before creating API keys. The API key will match your current plan. Free accounts start with generous limits. No credit card required!
Next Steps
- API Key Management - Create, rotate, and revoke keys
- Security Best Practices - Keep your keys safe
- Environment Setup - Configure your development environment