> ## Documentation Index
> Fetch the complete documentation index at: https://docs.typesafe.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Retries
> Configure retries with RetryPolicy — attempt count, retryable statuses, backoff, and retry headers handling.
export function SdkSignature({children}) {
async function copy(event) {
const button = event.currentTarget;
const code = button.parentElement.querySelector("pre code");
try {
await navigator.clipboard.writeText(code.textContent);
button.setAttribute("aria-label", "Signature copied");
button.dataset.copied = "true";
} catch {
button.setAttribute("aria-label", "Copy failed; select the signature to copy");
}
setTimeout(() => {
button.setAttribute("aria-label", "Copy signature");
delete button.dataset.copied;
}, 2000);
}
return ;
}
typesafe\_sdk.RetryPolicy dataclass
{"RetryPolicy"}{"("}{"\n"}{" "}{"max_retries"}{":"}{" "}{"int"}{" "}{"="}{" "}{"2"}{","}{"\n"}{" "}{"backoff_initial"}{":"}{" "}{"float"}{" "}{"="}{" "}{"0.5"}{","}{"\n"}{" "}{"backoff_max"}{":"}{" "}{"float"}{" "}{"="}{" "}{"5.0"}{","}{"\n"}{" "}{"backoff_jitter"}{":"}{" "}{"float"}{" "}{"="}{" "}{"0.25"}{","}{"\n"}{" "}{"http_statuses"}{":"}{" "}{"set"}{"["}{"int"}{"]"}{" "}{"="}{" "}{"("}{"\n"}{" "}{"lambda"}{":"}{" "}{"{"}{"408"}{","}{" "}{"429"}{","}{" "}{"*"}{"range"}{"("}{"500"}{","}{" "}{"600"}{")}"}{"\n"}{" "}{")(),"}{"\n"}{" "}{"respect_retry_after"}{":"}{" "}{"bool"}{" "}{"="}{" "}{"True"}{","}{"\n"}{" "}{"api_connection_error"}{":"}{" "}{"bool"}{" "}{"="}{" "}{"True"}{","}{"\n"}{" "}{"api_timeout_error"}{":"}{" "}{"bool"}{" "}{"="}{" "}{"True"}{","}{"\n"}{" "}{"exceptions"}{":"}{" "}{"set"}{"["}{"\n"}{" "}{"type"}{"["}{"BaseException"}{"]"}{"\n"}{" "}{"]"}{" "}{"="}{" "}{"set"}{"(),"}{"\n"}{" "}{"predicate"}{":"}{" "}{"Callable"}{"[["}{"BaseException"}{"],"}{" "}{"bool"}{"]"}{"\n"}{" "}{"|"}{" "}{"None"}{" "}{"="}{" "}{"None"}{","}{"\n"}{" "}{"timeout"}{":"}{" "}{"float"}{" "}{"|"}{" "}{"None"}{" "}{"="}{" "}{"30.0"}{","}{"\n"}{")"}{"\n"}
Configuration for SDK retry behavior.
Examples:
```python theme={null}
from typesafe_sdk import RetryPolicy, TypeSafeClient
client = TypeSafeClient(
retry=RetryPolicy(
max_retries=3, timeout=10.0, http_statuses={429, 500, 502, 503, 504}
)
)
```
max\_retries class-attribute instance-attribute
{"max_retries"}
{":"}
{" "}
{"int"}
{" "}
{"="}
{" "}
{"2"}
{"\n"}
Maximum retries after the initial attempt; `0` disables retries.
backoff\_initial class-attribute instance-attribute
{"backoff_initial"}
{":"}
{" "}
{"float"}
{" "}
{"="}
{" "}
{"0.5"}
{"\n"}
First backoff delay in seconds, doubled each attempt up to `backoff_max`.
backoff\_max class-attribute instance-attribute
{"backoff_max"}
{":"}
{" "}
{"float"}
{" "}
{"="}
{" "}
{"5.0"}
{"\n"}
Maximum backoff delay in seconds.
backoff\_jitter class-attribute instance-attribute
{"backoff_jitter"}
{":"}
{" "}
{"float"}
{" "}
{"="}
{" "}
{"0.25"}
{"\n"}
Fraction of each backoff delay randomly subtracted, between 0 and 1.
http\_statuses class-attribute instance-attribute
{"http_statuses"}{":"}{" "}{"set"}{"["}{"int"}{"]"}{" "}{"="}{" "}{"field"}{"("}{"\n"}{" "}{"default_factory"}{"="}{"lambda"}{":"}{" "}{"{"}{"\n"}{" "}{"408"}{","}{"\n"}{" "}{"429"}{","}{"\n"}{" "}{"*"}{"range"}{"("}{"500"}{","}{" "}{"600"}{"),"}{"\n"}{" "}{"}"}{"\n"}{")"}{"\n"}
HTTP status codes that are retried.
respect\_retry\_after class-attribute instance-attribute
{"respect_retry_after"}
{":"}
{" "}
{"bool"}
{" "}
{"="}
{" "}
{"True"}
{"\n"}
Whether to honor `Retry-After` and `retry-after-ms` response headers.
api\_connection\_error class-attribute instance-attribute
{"api_connection_error"}
{":"}
{" "}
{"bool"}
{" "}
{"="}
{" "}
{"True"}
{"\n"}
Whether to retry `TypeSafeAPIConnectionError`, raised when the request cannot reach or read from the server.
api\_timeout\_error class-attribute instance-attribute
{"api_timeout_error"}
{":"}
{" "}
{"bool"}
{" "}
{"="}
{" "}
{"True"}
{"\n"}
Whether to retry `TypeSafeAPITimeoutError`, raised when the request exceeds its timeout.
exceptions class-attribute instance-attribute
{"exceptions"}{":"}{" "}{"set"}{"["}{"type"}{"["}{"BaseException"}{"]]"}{" "}{"="}{" "}{"field"}{"("}{"\n"}{" "}{"default_factory"}{"="}{"set"}{"\n"}{")"}{"\n"}
Additional exception types that trigger a retry, on top of the built-in rules.
predicate class-attribute instance-attribute
{"predicate"}{":"}{" "}{"("}{"\n"}{" "}{"Callable"}{"[["}{"BaseException"}{"],"}{" "}{"bool"}{"]"}{" "}{"|"}{" "}{"None"}{"\n"}{")"}{" "}{"="}{" "}{"None"}{"\n"}
An optional predicate called with the raised exception; returning `True` triggers a retry in addition to the other rules.
timeout class-attribute instance-attribute
{"timeout"}
{":"}
{" "}
{"float"}
{" "}
{"|"}
{" "}
{"None"}
{" "}
{"="}
{" "}
{"30.0"}
{"\n"}
Total retry budget in seconds per SDK call, including the initial attempt and delays; `None` disables the limit.
Stops before a retry whose delay would reach or exceed the budget, re-raising the last error.