docs(OIDC): Document OIDC trust relationships and token exchange

[khvn26]

Thanks for submitting a PR! Please check the boxes below:

• I have read the Contributing Guide.
• I have added information to docs/ if required so people know about the feature.
• I have filled in the "Changes" section below.
• I have filled in the "How did you test this code" section below.

Changes

Closes #8040

In this PR, we add documentation for for OIDC trust relationships.

We document trust relationships on the Admin API authentication page, and update the API Keys tab references to API Access. We also add the two new environment variables (TRUST_RELATIONSHIP_ACCESS_TOKEN_LIFETIME_SECONDS, OIDC_TOKEN_EXCHANGE_THROTTLE_RATE) to the self-hosting reference.

The main piece can be previewed here: https://docs-git-feat-trust-relationships-docs-flagsmith.vercel.app/integrating-with-flagsmith/flagsmith-api-overview/admin-api/authentication#oidc-trust-relationships

How did you test this code?

Verified locally.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 20, 2026 12:51pm

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
flagsmith-frontend-preview	Ignored	Preview	Jul 20, 2026 12:51pm
flagsmith-frontend-staging	Ignored	Preview	Jul 20, 2026 12:51pm

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: a5a01e22-13e4-4f75-8866-84996bd1589a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}