Error Handling

What does a 401 error mean?

A 401 Unauthorized error means authentication failed. Check that:

Your API key is correct
The header format is Authorization: Bearer your-api-key
Your key has not been deactivated or rotated

What does a 429 error mean?

A 429 Too Many Requests error means you’re sending requests too frequently. Solutions:

Reduce your request frequency
Implement exponential backoff retry logic (see example below)
Contact support if you need higher rate limits

What does a 500 error mean?

A 500 Internal Server Error indicates a server-side issue. Steps to take:

Wait a moment and retry the request
Verify your request parameters are valid
If the error persists, contact support with your request details

How should I implement request retries?

Use exponential backoff with random jitter to avoid overwhelming the server:

import time
import random

def api_call_with_retry(func, max_retries=3):
    for attempt in range(max_retries):
        try:
            return func()
        except Exception as e:
            if attempt == max_retries - 1:
                raise e

            # Exponential backoff + random jitter
            wait_time = (2 ** attempt) + random.uniform(0, 1)
            time.sleep(wait_time)

For more advanced retry strategies, see Error Handling and Retry Mechanisms.

Overview

API Usage Guide

AI Agents

Code Examples

FAQ