The Feather API uses API keys to authenticate requests. Your API keys carry many privileges, so be sure to keep them secure and never share them in publicly accessible areas.

​
Getting Your API Key

  1. Log in to your Feather Dashboard
  2. Navigate to Settings → API Keys
  3. Click Generate New Key
  4. Copy your API key and store it securely
API keys are only shown once during creation. Make sure to copy and store your key in a secure location immediately.

​
API Key Header

Include your API key in the X-API-Key header: 
const API_KEY = process.env.FEATHER_API_KEY;

const response = await fetch('https://api.featherhq.com/v1/agents', {
  headers: {
    'X-API-Key': `${API_KEY}`,
    'Content-Type': 'application/json'
  }
});

​
Security Best Practices

​
Environment Variables

Always store your API keys in environment variables, never hardcode them: 
# .env file
FEATHER_API_KEY=your_api_key_here

​
Key Rotation

  • Rotate your API keys regularly (recommended: every 90 days)
  • Immediately rotate keys if they may have been compromised
  • Use separate keys for development and production environments

​
Access Control

  • Only give API keys to team members who need them
  • Use separate keys for different applications or services
  • Monitor API key usage in the dashboard

​
Rate Limits

Feather API has the following rate limits:
  • Standard Plan: 10 RPS
  • Enterprise: Custom limits available
When you exceed the rate limit, you’ll receive a 429 Too Many Requests response.

​
Error Codes

Status CodeDescription
401Invalid or missing API key
403API key doesn’t have required permissions
429Rate limit exceeded

​
Next Steps