API Key Generation

Learn how to generate and manage your urvo API keys. API keys are essential for authenticating with the urvo platform and accessing your voice agents programmatically.

Generating Your First API Key

Follow these steps to generate your first API key:

1. Log in to your urvo dashboard
2. Navigate to Settings → API Keys
3. Click "Create New API Key"
4. Choose your key type (Secret or Publishable)
5. Add a descriptive name for the key
6. Set permissions and restrictions (optional)
7. Click "Generate Key"

Key Management

Naming Conventions

Use descriptive names for your API keys to make management easier:

• Production Server: prod-server-main
• Development: dev-testing-environment
• CI/CD Pipeline: github-actions-deploy
• Mobile App: mobile-app-v2

Key Permissions

You can restrict API key permissions to enhance security:

Testing Your API Keys

Once you've generated an API key, test it with a simple request:

curl -X GET "https://api.urvo.io/v1/user" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

A successful response will return your user information:

{
  "id": "user_abc123",
  "email": "you@company.com",
  "name": "Your Name",
  "plan": "pro",
  "created_at": "2024-01-15T10:30:00Z"
}

Environment Setup

Store your API keys securely using environment variables:

# urvo API Configuration
URVO_API_KEY=sk-urvo-your-secret-key-here
URVO_API_URL=https://api.urvo.io/v1

# Optional: Set environment
NODE_ENV=production

Using in Code

Here's how to use environment variables in different languages:

const urvoApiKey = process.env.URVO_API_KEY;

const response = await fetch('https://api.urvo.io/v1/agents', {
  headers: {
    'Authorization': `Bearer ${urvoApiKey}`,
    'Content-Type': 'application/json'
  }
});

import os
import requests

api_key = os.getenv('URVO_API_KEY')

response = requests.get(
    'https://api.urvo.io/v1/agents',
    headers={
        'Authorization': f'Bearer {api_key}',
        'Content-Type': 'application/json'
    }
)

Key Rotation

Regularly rotate your API keys to maintain security:

1. Generate a new API key
2. Update your applications with the new key
3. Test that everything works correctly
4. Revoke the old API key
5. Monitor for any failed requests

Troubleshooting

Common Errors