Skip to content

Exceptions

Custom exception hierarchy for Assured API errors.

AssuredError

Bases: Exception

Base exception for all Assured SDK errors.

Source code in src/assured/exceptions.py 
8
9
class AssuredError(Exception):
    """Base exception for all Assured SDK errors."""

AssuredAPIError

Bases: AssuredError

Raised when the API returns a non-success HTTP status.

Source code in src/assured/exceptions.py 
12
13
14
15
16
17
18
19
class AssuredAPIError(AssuredError):
    """Raised when the API returns a non-success HTTP status."""

    def __init__(self, status_code: int, detail: Any = None, *, url: str = "") -> None:
        self.status_code = status_code
        self.detail = detail
        self.url = url
        super().__init__(f"HTTP {status_code} from {url}: {detail}")

AssuredAuthError

Bases: AssuredAPIError

Raised on HTTP 401 — invalid or missing API key.

Source code in src/assured/exceptions.py 
22
23
class AssuredAuthError(AssuredAPIError):
    """Raised on HTTP 401 — invalid or missing API key."""

AssuredNotFoundError

Bases: AssuredAPIError

Raised on HTTP 404 — resource not found.

Source code in src/assured/exceptions.py 
26
27
class AssuredNotFoundError(AssuredAPIError):
    """Raised on HTTP 404 — resource not found."""

AssuredValidationError

Bases: AssuredAPIError

Raised on HTTP 400 — bad request / validation failure.

Source code in src/assured/exceptions.py 
30
31
class AssuredValidationError(AssuredAPIError):
    """Raised on HTTP 400 — bad request / validation failure."""

AssuredRateLimitError

Bases: AssuredAPIError

Raised on HTTP 429 — rate limited (after retries exhausted).

Source code in src/assured/exceptions.py 
34
35
class AssuredRateLimitError(AssuredAPIError):
    """Raised on HTTP 429 — rate limited (after retries exhausted)."""