> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and solutions when working with Archetype's APIs

## 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:

```bash theme={"system"}
conda create -n archetype python=3.10
conda activate archetype
pip install archetypeai
```

## Troubleshooting Checklist

<Steps>
  <Step title="Verify Python Client Version">
    Ensure you have the latest version of the Python client installed. See the [Python client documentation](/libraries/python#upgrade-python-client) for full installation and upgrade instructions.

    Show your installed version:

    ```bash theme={"system"}
    pip show archetypeai
    ```

    Upgrade to the latest version:

    ```bash theme={"system"}
    pip install --upgrade archetypeai
    ```
  </Step>

  <Step title="Verify Authentication">
    * Check API key format: `Bearer YOUR_API_KEY`
    * Verify key hasn't been revoked in Developer Console
    * Ensure correct environment (dev/prod)
  </Step>

  <Step title="Check Request Format">
    * Validate required parameters are included
    * Verify JSON formatting for POST requests
    * Check file formats and sizes for uploads
  </Step>

  <Step title="Review Error Response">
    * Read error code and message carefully
    * Check details object for additional context
    * Look for retry\_after values for rate limits
  </Step>

  <Step title="Implement Proper Retry Logic">
    * Use exponential backoff for server errors
    * Respect rate limit retry\_after values
    * Don't retry client errors (4xx except 429)
  </Step>

  <Step title="Monitor and Log">
    * Log all errors with context
    * Set up alerts for high error rates
    * Track error patterns over time
  </Step>
</Steps>

## Getting Help

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

<CardGroup cols={2}>
  <Card title="Check API Status" icon="chart-line" href="https://status.archetypeai.app/">
    View current system status and incidents
  </Card>

  <Card title="Request Access" icon="key" href="https://docs.archetypeai.app/support/request_access">
    Request API access if you don't have it yet
  </Card>

  <Card title="Contact Support" icon="headset" href="mailto:support@archetypeai.dev">
    Get help from our technical support team at [support@archetypeai.dev](mailto:support@archetypeai.dev)
  </Card>

  <Card title="Support Docs" icon="book" href="https://docs.archetypeai.app/support/support">
    Browse additional support documentation
  </Card>
</CardGroup>

When contacting support, please include:

* Error codes and messages
* Request/response examples
* Timestamps of errors
* Your organization ID
* Steps to reproduce the issue