Skip to main content

Error Handling

The API uses standard HTTP status codes and returns detailed error information in a consistent format.

Error Response Format

All errors return a JSON object with the following structure:
Save the request_id from error responses. When contacting support, include this ID for faster troubleshooting.

HTTP Status Codes

Error Codes Reference

Authentication Errors (401)

OAuth Errors (401/403)

Device Auth Errors (400)

Validation Errors (400)

Server Errors (500)

Handling Errors

JavaScript/TypeScript

Python

Validation Error Details

When you receive a validation_error, the details.issues array contains specific validation failures:

Response Headers

Every response includes: