Document health_checks and auto_reauth connection flags

[aylee855]

Summary

Adds documentation for the two new managed-auth connection flags shipped on the API:

• health_checks (boolean, default true) — whether periodic health checks run at all.
• auto_reauth (boolean, default true) — whether a failing scheduled health check is allowed to attempt re-authentication.

Updates /auth/configuration:

• Expands "Credentials and Auto-Reauth" to introduce both flags, the interaction between them (auto_reauth is only meaningful while health_checks is true), and a create-time example with both disabled.
• Notes that auto_reauth: true is opt-in only — connections still transition to NEEDS_AUTH when reauth preconditions (e.g. saved credentials) aren't met.
• Adds both fields to the "Updating a Connection" table and notes the changes take effect immediately on the running connection.

Test plan

• Preview renders cleanly on Mintlify
• Code samples copy/paste correctly in both TypeScript and Python

---

Note

Low Risk
Low risk documentation-only change; no product logic or APIs are modified.

Overview
Adds documentation to auth/configuration.mdx explaining the new connection flags health_checks and auto_reauth, including their defaults, interaction, and the fact that auto_reauth is best-effort and may still result in NEEDS_AUTH.

Updates examples to show disabling both flags at creation time, and extends the connection update table/notes to include these fields and clarify that changes take effect immediately.

^{Reviewed by Cursor Bugbot for commit cb6ee08. 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 22, 2026, 12:24 AM

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

[masnwilliams]

lgtm

[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 updates documentation for existing API flags; it does not change kernel API endpoints or Temporal workflows themselves.

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

[cursor]

Risk assessment: Very Low.

This PR only updates auth/configuration.mdx with documentation for health_checks and auto_reauth. I found no production code, config, schema, infrastructure, or shared-library changes in the diff, and no CODEOWNERS file requiring a code owner review for this path.

The PR is already approved, so I did not add another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}