API Exceptions

class BaseAPIException(status_code: int, message: str, headers: dict[str, str] | None = None)[source]

Bases: Exception

Base exception for all API-related errors.

status_code int
message str
headers dict | None

Standard HTTP Exceptions

class UnauthorizedException(message: str = 'Not authenticated')[source]

Bases: BaseAPIException

401 Unauthorized exception.

class UserNotFound[source]

Bases: BaseAPIException

404 User not found exception.

class BadRequestException(message: str)[source]

Bases: BaseAPIException

400 Bad Request exception.

class ConflictException(message: str)[source]

Bases: BaseAPIException

409 Conflict exception.

class PermissionDeniedException(message: str)[source]

Bases: BaseAPIException

403 Permission Denied exception.

class NotFoundException(message: str)[source]

Bases: BaseAPIException

404 Not Found exception.

System & Startup Exceptions

class JWTKeyConfigError(message: str)[source]

Bases: RuntimeError

Raised when the JWT private key is missing, corrupted, or invalid.