Skip to main content

​
Common Errors

​
Python Version Error

If you see an error like: 
TypeError: unsupported operand type(s) for |: 'type' and 'type'
This means your Python version is below 3.10. The Archetype AI client requires Python 3.10 or higher. Create a new environment with: 
conda create -n archetype python=3.10
conda activate archetype
pip install archetypeai

​
Troubleshooting Checklist

1

Verify Python Client Version

Ensure you have the latest version of the Python client installed. See the Python client documentation for full installation and upgrade instructions.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

Contact Support

Get help from our technical support team at [email protected]

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