Skip to main content

​
Troubleshooting

​
Troubleshooting Checklist

1

Verify Authentication

  • Check API key format: Bearer YOUR_API_KEY
  • Verify key hasn’t been revoked in Developer Console
  • Ensure correct environment (dev/prod)
2

Check Request Format

  • Validate required parameters are included
  • Verify JSON formatting for POST requests
  • Check file formats and sizes for uploads
3

Review Error Response

  • Read error code and message carefully
  • Check details object for additional context
  • Look for retry_after values for rate limits
4

Implement Proper Retry Logic

  • Use exponential backoff for server errors
  • Respect rate limit retry_after values
  • Don’t retry client errors (4xx except 429)
5

Monitor and Log

  • Log all errors with context
  • Set up alerts for high error rates
  • Track error patterns over time

​
Getting Help

If you’re still experiencing issues after following this guide:

Check API Status

View current system status and incidents
When contacting support, please include:
  • Error codes and messages
  • Request/response examples
  • Timestamps of errors
  • Your organization ID
  • Steps to reproduce the issue