Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ansa.so/llms.txt

Use this file to discover all available pages before exploring further.

​
API Keys

API keys provide programmatic access to the Ansa API.

​
Generating a Key

  1. Go to Settings > API in your dashboard
  2. Click Generate API Key
  3. 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": "user@example.com",
  "password": "your-password"
}

POST /auth/magic-link
Content-Type: application/json

{
  "email": "user@example.com",
  "callbackUrl": "https://app.example.com/auth/callback"
}

​
OAuth

Redirect users to: 
GET /auth/sign-in/google
GET /auth/sign-in/github

​
Widget Authentication

The chat widget uses a separate authentication flow for end-users:

​
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: "customer@example.com",
  userName: "John Doe"
};
This allows you to:
  • Track conversations by user
  • See user information in the dashboard
  • Build user-aware responses