API v1 Documentation — View changelog
Vozia

Authentication

The Vozia API uses API keys to authenticate requests. You can manage your API keys in the Dashboard.

API Keys

Include your API key in the Authorization header of all requests:

Header
Authorization: Bearer vz_live_abc123...

Key Types

vz_live_* Production

Use in production. Has access to all features and is billed.

vz_test_* Test

Use for development and testing. Limited rate limits, not billed.

Session Authentication

For web applications, you can also authenticate users via session cookies. Use the auth endpoints to manage sessions:

POST /auth/signup Create account POST /auth/login Log in POST /auth/logout Log out GET /auth/me Get current user

Code Examples

JavaScript
class="hl-comment">// Using API Key
const response = await fetch(class="hl-string">'https:class="hl-comment">//api.vozia.io/v1/podcasts', {
  headers: {
    class="hl-string">'Authorization': class="hl-string">'Bearer vz_live_abc123...',
    class="hl-string">'Content-Type': class="hl-string">'application/json'
  }
});

class="hl-comment">// Using SDK (recommended)
import { Vozia } from class="hl-string">'@vozia/sdk';

const vozia = new Vozia({
  apiKey: process.env.VOZIA_API_KEY
});

const podcasts = await vozia.podcasts.list();
Python
import vozia

client = vozia.Client(api_key="vz_live_abc123...")

# List podcasts
podcasts = client.podcasts.list()

# Or set via environment variable
# export VOZIA_API_KEY=vz_live_abc123...
client = vozia.Client()  # Auto-reads from env

Security Best Practices

  • Never expose your API key in client-side code
  • Use environment variables to store keys
  • Rotate keys regularly and revoke compromised keys immediately
  • Use test keys (vz_test_*) during development

Rate Limiting

API requests are rate limited based on your plan. When rate limited, you'll receive a 429 Too Many Requests response. See rate limits for details.