Skip to main content

Overview

All Valiqor exceptions inherit from ValiqorError. Catch this base class to handle any SDK error, or catch specific subclasses for granular error handling.

Exception Hierarchy


Base Exception

ValiqorError

Base class for all Valiqor SDK errors.

Authentication Errors

ConfigurationError

Raised when the SDK is misconfigured — missing API key, invalid config file, or incompatible settings.

AuthenticationError

Raised when the API key is invalid, expired, or unauthorized.

AccountDeactivatedError

Raised when the account has been deactivated.

Rate & Quota Errors

RateLimitError

Raised when too many requests are sent in a short period.

QuotaExceededError

Raised when monthly usage quota is reached.

TokenQuotaExceededError

Raised when token usage quota is exceeded (subclass of QuotaExceededError).

Validation Errors

ValidationError

Raised when input data fails validation — bad format, missing fields, or invalid parameters.

DatasetTooLargeError

Raised when the dataset exceeds the maximum allowed size.

Network & Timeout Errors

TimeoutError

Raised when a request exceeds the timeout duration.

NetworkError

Raised when the SDK cannot reach the backend.

UploadError

Raised when a trace or scan upload fails (subclass of NetworkError).

API Errors

APIError

Generic API error with status code and response details.

ServiceUnavailableError

Raised when the backend is temporarily unavailable (503).

Module-Specific Errors

TracingError

Raised for errors during trace capture or export.

ScanError

Raised for errors during code scanning.

EvaluationError

Raised for errors during evaluation runs.

SecurityError

Raised for errors during security audits or red team runs.

Error Handling Pattern