Skip to content

SK-3002 add README docs for configurable timeouts and retries#370

Merged
Devesh-Skyflow merged 1 commit into
v3from
devesh/SK-3002-add-readme
Jul 22, 2026
Merged

SK-3002 add README docs for configurable timeouts and retries#370
Devesh-Skyflow merged 1 commit into
v3from
devesh/SK-3002-add-readme

Conversation

@Devesh-Skyflow

@Devesh-Skyflow Devesh-Skyflow commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

What

Documents the configurable HTTP timeout & retry settings shipped in Release/26.7.15 (#361). Docs-only — no code changes.

Adds a Configure timeouts and retries section to the README covering:

  • Client-wide config on Skyflow.builder() (timeout, maxRetries, initialRetryDelayMillis, maxRetryDelayMillis)
  • Per-vault config on VaultConfig (setTimeout, setMaxRetries, setInitialRetryDelayMillis, setMaxRetryDelayMillis)
  • Settings table with units and defaults
  • Precedence: per-vault > client-wide > SDK default, resolved per field
  • Retry behavior: retries on 408/429/5xx with exponential backoff + jitter; honors Retry-After / X-RateLimit-Reset; off by default
  • Timeout behavior: surfaces HTTP 408 with message Request timed out.

Why

The feature is already in v3 but was undocumented. All API names were verified against the current v3 source.

Testing

Docs-only change; no build impact.

Document the timeout/retry settings introduced in Release/26.7.15:
- client-wide config on Skyflow.builder() and per-vault config on VaultConfig
- settings table (timeout, maxRetries, initialRetryDelayMillis, maxRetryDelayMillis) with units/defaults
- precedence (per-vault > client-wide > default, resolved per field)
- retry behavior (408/429/5xx, backoff+jitter, Retry-After/X-RateLimit-Reset) and 408 timeout error

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Devesh-Skyflow
Devesh-Skyflow changed the base branch from main to v3 July 22, 2026 14:04
@Devesh-Skyflow Devesh-Skyflow changed the title Devesh/sk 3002 add readme SK-3002 add README docs for configurable timeouts and retries Jul 22, 2026
@Devesh-Skyflow
Devesh-Skyflow merged commit 63a2768 into v3 Jul 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants