Which statuses retry by default?

408, 429, and the 500-599 range, with connection and timeout errors retrying as well. max_retries 0 turns retries off, and respect_retry_after honors Retry-After and retry-after-ms headers.

What are the default retry numbers?

max_retries 2, backoff_initial 0.5s, backoff_max 5s, backoff_jitter 0.25, and a 30-second total budget. The usage guide shows a different example policy; this page is the dataclass default.

How does the backoff schedule work?

backoff_initial is doubled each attempt up to backoff_max, and backoff_jitter subtracts a random fraction of each delay between 0 and 1. Setting either backoff value to zero disables backoff.

How does the total retry budget behave?

timeout is the total budget per SDK call, covering the initial attempt and all delays. The client stops before a retry whose delay would reach or exceed the budget and re-raises the last error; None disables the limit.

Can I retry on my own exception types?

Yes. exceptions lists extra exception types that trigger a retry on top of the built-in rules, and predicate is called with the raised exception; returning True forces a retry.

Are connection and timeout errors retried?

They are governed by api_connection_error and api_timeout_error, each enabling retries for its error class. TypeSafeAPIConnectionError covers unreachable or unreadable requests, and TypeSafeAPITimeoutError covers exceeded timeouts.

When are Retry-After headers honored?

When respect_retry_after is on, the SDK honors Retry-After and retry-after-ms response headers. Otherwise it falls back to its own backoff schedule.

OfficialJev Repos & SDKs

Python SDK Retries

RetryPolicy for the Python SDK: attempt count, exponential backoff with jitter, which HTTP statuses retry, and a total time budget.

See highlights

Open docs.typesafe.ai

Format: Docs
Published by: TypeSafe AI
Last verified: Oct 2026

Tagsofficial docs sdk python retries

Works forJev for Classification

Used inJev for Software & DevTools

Languages: Python

Highlights

Defaults are max_retries 2, backoff_initial 0.5s, backoff_max 5s, backoff_jitter 0.25, and timeout 30s.
Retried statuses are 408, 429, and the 500-599 range. max_retries 0 turns retries off.
respect_retry_after honors Retry-After and retry-after-ms. Connection and timeout errors retry by default.
A predicate or extra exception types can force another retry. The budget stops a retry that would exceed it.

Quickstart

python

from typesafe_sdk import RetryPolicy, TypeSafeClient

client = TypeSafeClient(
    retry=RetryPolicy(
        max_retries=3,
        timeout=10.0,
        http_statuses={429, 500, 502, 503, 504},
    )
)

Watch out

The usage guide shows a different example policy. This page is the dataclass default.

Questions about this entry

Short answers drawn from the linked project or page.

Reactions & coverage

Posts, threads, and videos about this entry from around the web.

X: Failing open or failing closed is a per-action choice, not a global default.

This post couldn't be loaded here — read it on X.https://x.com/jevdirectory/status/2781000000000000004

Related terms

Glossary definitions related to this entry.

More Jev resources like this

Python SDK Exceptions

The Python SDK error hierarchy: HTTP status classes, rate-limit wait hints, connection and timeout errors, and response-body validation failures.