Skip to content

docs(sdks): document Java retry backoff schedule client options#6168

Open
devin-ai-integration[bot] wants to merge 5 commits into
mainfrom
devin/1783616990-java-retry-backoff-options
Open

docs(sdks): document Java retry backoff schedule client options#6168
devin-ai-integration[bot] wants to merge 5 commits into
mainfrom
devin/1783616990-java-retry-backoff-options

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

The generated Java SDK client builder exposes three runtime options controlling the exponential backoff schedule between retries, alongside the existing maxRetries. These are runtime builder methods on the generated client, not generators.yml config (verified against ICustomConfig.java, which only defines maxRetries), so they're documented on the canonical runtime retry page (Retries with backoff) rather than in configuration.mdx.

Added a ### Customizing the backoff schedule subsection to retries-with-backoff.mdx with a Java example and the three options + defaults:

  • initialRetryDelayMillis (default 1000)
  • maxRetryDelayMillis (default 60000)
  • retryJitterFactor (default 0.2, between 0 and 1)

Available on both the root client builder and ClientOptions.Builder.

Also added an inline cross-reference from the maxRetries entry in the Java configuration.mdx (a generators.yml reference) to the new backoff section, so readers who land on the config page can find the runtime tuning options:

 The default number of retries for failed requests. ... SDK users can still override this
-per-request via request options.
+per-request via request options, and can tune the [backoff schedule between retries](...#customizing-the-backoff-schedule) at client instantiation.

Source: fern-api/fern#16973.

Link to Devin session: https://app.devin.ai/sessions/ebd4f54345f542ad8d0afa752122b2ee

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration devin-ai-integration Bot requested a review from devalog as a code owner July 9, 2026 17:11
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

devalog and others added 4 commits July 9, 2026 18:42
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
…rride

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
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.

1 participant