Skip to main content

​
Troubleshooting Checklist

1

Verify Python Client Version

Ensure you have the latest version of the Python client installed.Show your installed version:
pip show archetypeai
Upgrade to the latest version:
pip install --upgrade archetypeai
2

Verify Authentication

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

Check Request Format

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

Review Error Response

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

Implement Proper Retry Logic

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

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

Request Access

Request API access if you don’t have it yet

Support Docs

Browse additional support documentation
When contacting support, please include:
  • Error codes and messages
  • Request/response examples
  • Timestamps of errors
  • Your organization ID
  • Steps to reproduce the issue