Authentication
The Synchr.ai API uses API keys for authentication. Include your API key in the Authorization header of every request:
Authorization: Bearer sk_live_your_api_key_hereGetting Your API Key
Navigate to Settings > API in your Synchr.ai dashboard. Click "Generate API Key" to create a new key. You can create multiple keys for different environments (development, staging, production).
Key Types
sk_live_*— Production keys with full accesssk_test_*— Test keys that operate in sandbox mode
Rate Limits
API rate limits depend on your plan:
- Free — 100 requests per minute
- Pro — 1,000 requests per minute
- Business — 5,000 requests per minute
- Enterprise — Custom limits
Rate Limit Headers
Every API response includes headers to help you track your usage:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1706500000Handling Rate Limits
When you exceed the rate limit, the API returns a 429 Too Many Requests response. Implement exponential backoff in your integration to handle this gracefully:
- Wait 1 second, then retry
- If still rate limited, wait 2 seconds, then retry
- If still rate limited, wait 4 seconds, then retry
- Continue doubling the wait time up to a maximum of 60 seconds
Security Best Practices
- Never expose API keys in client-side code or public repositories
- Rotate keys periodically and after team member departures
- Use test keys during development
- Set IP allowlists for production keys when possible