docs: shared connection configuration page for managed auth

[masnwilliams]

Summary

Restructures the managed auth docs so connection-level options live in one place, and documents the Custom Proxy option for the first time.

• New page auth/configuration.mdx holding all the shared connection-level options: credentials, custom login URL, SSO/OAuth, custom proxy, session recording, post-login URL, and updates. These apply to every integration flow (hosted UI, React, programmatic), so they shouldn't live under one of them.
• auth/hosted-ui.mdx and auth/programmatic.mdx slimmed down — each page now only covers its integration flow and links out to the shared config page.
• auth/react.mdx had no mention of these options at all; added a pointer so React users discover them.
• Added auth/configuration to docs.json nav under Auth.
• Documents the Custom Proxy option (the original ask: BYO static IP / proxy for managed auth flows, CUS-210). Covers attach on create, swap on update, per-login override, and is explicit about exit-IP stability per proxy type (ISP/datacenter static, residential rotating, custom BYO for fully customer-controlled static).
• Copy cleanup: dropped internal "running connection workflow" phrasing in favor of user-observable behavior; simplified the session-recording description.

Test plan

• Mintlify preview renders the new Connection Configuration page in nav
• Hosted UI / React / Programmatic pages link out to the shared page
• Cross-links from auth/faq.mdx resolve to the new anchors
• Code samples compile against the current SDK shape

---

Note

Low Risk
Low risk documentation-only restructure; main risk is broken links/anchors or nav placement changes in Mintlify.

Overview
Adds a new shared auth/configuration.mdx page that centralizes Managed Auth connection-level options (credential saving/auto-reauth, custom login_url, SSO allowed_domains, custom proxy usage, record_session + replay_id, post_login_url, and auth.connections.update).

Updates the Hosted UI and Programmatic guides to remove duplicated configuration sections and link to the new page, adds the same pointer to the React guide, and adjusts the FAQ’s session-recording cross-link. Exposes the new page in the docs.json Auth navigation.

^{Reviewed by Cursor Bugbot for commit 507b1d8. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	May 13, 2026, 4:07 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[firetiger-agent]

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

Any PR that changes the kernel API. Monitor changes to API endpoints (packages/api/cmd/api/) and Temporal workflows (packages/api/lib/temporal) in the kernel repo

Reason: PR only modifies documentation files (auth configuration docs) with no changes to API endpoints or Temporal workflows.

To monitor this PR anyway, reply with @firetiger monitor this.

[cursor]

Stale comment

Risk assessment: Very Low.

I verified the diff directly: this only adds/reorganizes Mintlify documentation under auth/*.mdx and adds one docs.json navigation entry. There are no production codepaths, infrastructure changes, auth/permission logic changes, schema changes, or shared runtime systems modified.

I also found no CODEOWNERS file. The PR is already approved at the current head commit, so I’m not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low.

I re-evaluated the current diff directly. The PR only adds/reorganizes Mintlify documentation under auth/*.mdx and adds one docs.json navigation entry; the latest update adds a short auth/react.mdx cross-link to the shared connection configuration page. There are no production codepaths, infrastructure changes, auth/permission logic changes, schema changes, or shared runtime systems modified.

I found no CODEOWNERS file. The PR is already approved and the update does not increase risk, so I’m not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low.

I re-evaluated the latest PR diff directly at the current head. The changes are limited to Mintlify documentation under auth/*.mdx plus one docs.json navigation entry for the new shared connection configuration page. The newest update only simplifies wording around session recording; it doesn’t modify production codepaths, infrastructure, auth/permission logic, schemas, or shared runtime systems.

I found no CODEOWNERS file. The PR is already approved, and the current update does not increase risk, so I’m not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low.

I reviewed the current diff directly. The PR is limited to Mintlify documentation changes in auth/*.mdx plus one docs.json navigation entry for the new shared connection configuration page. It moves existing managed-auth configuration guidance into a shared docs page and adds copy/cross-links for custom proxy and session recording behavior.

I found no production codepath changes, infrastructure changes, auth/permission logic changes, schema changes, prompt/instruction-file changes, or shared runtime system changes. I also found no CODEOWNERS file in the repository.

The PR is already approved, and this update does not increase risk, so I’m not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low.

I reviewed the current diff directly. The changes are limited to Mintlify documentation under auth/*.mdx plus one docs.json navigation entry for the new shared connection configuration page. The update moves connection-level managed-auth guidance into a shared page and adjusts links/copy around proxy and session recording behavior.

I found no production codepath changes, infrastructure changes, auth/permission logic changes, schema changes, prompt/instruction-file changes, or shared runtime system changes. I also found no CODEOWNERS file in the repository.

The PR is already approved, and this update does not increase risk, so I’m not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low.

I re-evaluated the current diff directly at head 507b1d8. The PR is limited to Mintlify documentation changes: a new auth/configuration.mdx page, small auth-doc cross-link/copy updates, and one docs.json navigation entry.

I found no production codepath changes, infrastructure changes, auth/permission logic changes, schema changes, prompt/instruction-file changes, or shared runtime system changes. I also found no CODEOWNERS file in the repository.

GitHub currently reports the PR as approved, and this update does not increase risk, so I’m not submitting another approval or revoking the existing one.

  

_{Sent by Cursor Automation: Assign PR reviewers}