Exceptions

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

status = status

HTTP response status code.

body

instance-attribute

body = body

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

headers

instance-attribute

headers = headers

HTTP response headers.

endpoint

instance-attribute

endpoint = endpoint

The request method and URL, without credentials, query parameters, or fragment, when available.

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

retry_after_ms = parse_retry_after(headers)

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

timeout = timeout

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

field_path = field_path

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

args

instance-attribute

args = (
    status,
    body,
    headers,
    field_path,
    endpoint,
)

Introduction

TypeSafe concepts

TypeSafe foundations

Patterns

Demos

Client SDKs

Reference

Cookbooks

Base exception

typesafe_sdk.TypeSafeError

HTTP errors

typesafe_sdk.TypeSafeAPIError

status

body

headers

endpoint

request_id

typesafe_sdk.TypeSafeBadRequestError

typesafe_sdk.TypeSafeAuthenticationError

typesafe_sdk.TypeSafePermissionDeniedError

typesafe_sdk.TypeSafeNotFoundError

typesafe_sdk.TypeSafeUnprocessableEntityError

typesafe_sdk.TypeSafeRateLimitError

retry_after_ms

typesafe_sdk.TypeSafeInternalServerError

Connection errors

typesafe_sdk.TypeSafeAPIConnectionError

typesafe_sdk.TypeSafeAPITimeoutError

timeout

Response validation

typesafe_sdk.TypeSafeAPIResponseValidationError

field_path

args

​Base exception

​typesafe_sdk.TypeSafeError

​HTTP errors

​typesafe_sdk.TypeSafeAPIError

​status

​body

​headers

​endpoint

​request_id

​typesafe_sdk.TypeSafeBadRequestError

​typesafe_sdk.TypeSafeAuthenticationError

​typesafe_sdk.TypeSafePermissionDeniedError

​typesafe_sdk.TypeSafeNotFoundError

​typesafe_sdk.TypeSafeUnprocessableEntityError

​typesafe_sdk.TypeSafeRateLimitError

​retry_after_ms

​typesafe_sdk.TypeSafeInternalServerError

​Connection errors

​typesafe_sdk.TypeSafeAPIConnectionError

​typesafe_sdk.TypeSafeAPITimeoutError

​timeout

​Response validation

​typesafe_sdk.TypeSafeAPIResponseValidationError

​field_path

​args

Base exception

typesafe_sdk.TypeSafeError

HTTP errors

typesafe_sdk.TypeSafeAPIError

status

body

headers

endpoint

request_id

typesafe_sdk.TypeSafeBadRequestError

typesafe_sdk.TypeSafeAuthenticationError

typesafe_sdk.TypeSafePermissionDeniedError

typesafe_sdk.TypeSafeNotFoundError

typesafe_sdk.TypeSafeUnprocessableEntityError

typesafe_sdk.TypeSafeRateLimitError

retry_after_ms

typesafe_sdk.TypeSafeInternalServerError

Connection errors

typesafe_sdk.TypeSafeAPIConnectionError

typesafe_sdk.TypeSafeAPITimeoutError

timeout

Response validation

typesafe_sdk.TypeSafeAPIResponseValidationError

field_path

args