API Keys
API keys provide programmatic access to the Ansa API.
Generating a Key
- Go to Settings > API in your dashboard
- Click Generate API Key
- Copy the key immediately - it won’t be shown again
Using API Keys
Include the key in the Authorization header:
curl -X GET https://api.ansa.so/agents \
-H "Authorization: Bearer ansa_sk_xxxxxxxxxxxxxxxx"
Key Permissions
API keys have the same permissions as your account:
- Access to all your agents
- Ability to create/update/delete resources
- Usage counts against your plan limits
Keep your API keys secure. Never expose them in client-side code or public repositories.
Session Authentication
For dashboard and widget authentication, Ansa uses cookie-based sessions:
Sign In
POST /auth/sign-in/email
Content-Type: application/json
{
"email": "[email protected]",
"password": "your-password"
}
Magic Link
POST /auth/magic-link
Content-Type: application/json
{
"email": "[email protected]",
"callbackUrl": "https://app.example.com/auth/callback"
}
OAuth
Redirect users to:
GET /auth/sign-in/google
GET /auth/sign-in/github
Anonymous Sessions
By default, widget users are anonymous. A session ID is stored in localStorage.
Identified Users
Pass user information to track conversations:
window.__ansa_config = {
agentId: "xxx",
userId: "user_123",
userEmail: "[email protected]",
userName: "John Doe"
};
- Track conversations by user
- See user information in the dashboard
- Build user-aware responses
