Error Codes

All errors return a JSON body with code, message, and optional details.

CodeHTTP StatusDescription
auth_required401Missing or invalid authentication
forbidden403Insufficient permissions
not_found404Resource does not exist
validation_error422Request body failed validation
rate_limited429Too many requests
internal_error500Unexpected server error