Skip to main content

​
Base exception

​
typesafe_sdk.TypeSafeError

Bases: Exception Base exception for SDK failures.

​
HTTP errors

​
typesafe_sdk.TypeSafeAPIError

Bases: TypeSafeError An unsuccessful HTTP response with its body and request metadata.

​
status instance-attribute

HTTP response status code.

​
body instance-attribute

The server’s JSON error body, plain response text, or None for an empty body.

​
headers instance-attribute

HTTP response headers.

​
request_id property

The x-typesafe-request-id response header, or None if absent.

​
typesafe_sdk.TypeSafeBadRequestError

Bases: TypeSafeAPIError The request was invalid (400).

​
typesafe_sdk.TypeSafeAuthenticationError

Bases: TypeSafeAPIError Authentication failed (401).

​
typesafe_sdk.TypeSafePermissionDeniedError

Bases: TypeSafeAPIError Access was denied (403).

​
typesafe_sdk.TypeSafeNotFoundError

Bases: TypeSafeAPIError The resource was not found (404).

​
typesafe_sdk.TypeSafeUnprocessableEntityError

Bases: TypeSafeAPIError The request failed server validation (422).

​
typesafe_sdk.TypeSafeRateLimitError

Bases: TypeSafeAPIError The rate limit was exceeded (429).

​
retry_after_ms instance-attribute

The server’s requested wait in milliseconds, or None if unavailable.

​
typesafe_sdk.TypeSafeInternalServerError

Bases: TypeSafeAPIError The server failed to process the request (5xx).

​
Connection errors

​
typesafe_sdk.TypeSafeAPIConnectionError

Bases: TypeSafeError, ConnectionError A request failed without an HTTP response.

​
typesafe_sdk.TypeSafeAPITimeoutError

Bases: TypeSafeAPIConnectionError, TimeoutError A request exceeded its configured timeout.

​
timeout instance-attribute

The timeout setting used for the request, in seconds or as an httpx2.Timeout.

​
Response validation

​
typesafe_sdk.TypeSafeAPIResponseValidationError

Bases: TypeSafeAPIError A successful HTTP response whose body was missing or structurally invalid required data.

​
field_path instance-attribute

Dotted path to the offending field, such as answers.tone.confidence.