Skip to content

docs: document user-agent template behavior with platform headers - #6487

Open
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785517757-user-agent-platform-headers
Open

docs: document user-agent template behavior with platform headers#6487
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785517757-user-agent-platform-headers

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

SDKs can send a custom User-Agent built from a user-agent template in generators.yml, and they can also send a structured User-Agent carrying OS, architecture, and runtime info when platform headers are enabled. Until recently, Python, TypeScript, and C# dropped the configured template when platform headers were on and fell back to the package name. That's now fixed, so customers who set a custom User-Agent for attribution or analytics get their exact product token in every request regardless of platform headers, and server-side telemetry is consistent across languages.

Implements docs for: fix(python, typescript, csharp): honor user-agent template with platform headers (fern-api/fern#17298)

Changes:

  • Added a user-agent config option to the Python, TypeScript, and C# generator configuration references (previously only documented for Java), covering the placeholders and the resulting header.
  • Documented the combined result on all four pages: the resolved template becomes the product token, followed by the platform and runtime segments (plantstore-python-sdk/0.1.0 (linux; x86_64) Python/3.11.0), and a resolved value whose trailing segment isn't a version (@plantstore/sdk) is used as-is with no version appended.
  • Cross-linked the includePlatformHeaders option on each page to the user-agent option.

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

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 31, 2026 17:09
@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

Copy link
Copy Markdown
Contributor

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.

0 participants