Overview
All Valiqor exceptions inherit fromValiqorError. 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
Related
- Troubleshooting — Common issues and fixes
- Configuration — Avoid
ConfigurationError - Rate Limits — Understand rate and quota limits