Skip to main content
All Freya API endpoints require a Bearer token for authentication. This token is tied to your workspace and can be generated from the dashboard.

​
1. Create an account

Head to app.freyavoice.ai and sign up for a free account.

Sign up for Freya

Create your account and workspace at app.freyavoice.ai

​
2. Create a workspace

After signing in, you’ll be prompted to create your first workspace. Workspaces are isolated environments — each one has its own agents, phone numbers, and API keys.
If you already have a workspace, you can skip this step and go straight to generating an API key.

​
3. Generate an API key

Once inside your workspace:
1

Open API Keys

In the sidebar, scroll to the Settings section and click API Keys.
2

Create a new key

Click Create API Key, give it a name, and copy the generated token. Store it somewhere safe — it won’t be shown again.
You can also find a link to the API documentation directly on the API Keys page — click View API Docs next to the Create button.

​
4. Use the token in requests

Pass the token as a Bearer token in the Authorization header of every API request: 
Authorization: Bearer <your-api-key>

​
Example

curl -X POST "https://stt.freyavoice.ai/v1/audio/transcriptions" \
  -H "Authorization: Bearer <your-api-key>" \
  -F "file=@audio.wav"
Never expose your API key in client-side code or public repositories. Use environment variables or a secrets manager to keep it secure.