Skip to content

Update managed auth docs for CUA-based login flow#256

Closed
masnwilliams wants to merge 1 commit intomainfrom
hypeship/local-development-workflows-20260311-051815
Closed

Update managed auth docs for CUA-based login flow#256
masnwilliams wants to merge 1 commit intomainfrom
hypeship/local-development-workflows-20260311-051815

Conversation

@masnwilliams
Copy link
Contributor

Summary

  • Updates managed auth documentation to reflect migration from DOM-based (ODA) to CUA (Computer Use Agent) login flows
  • Documents new API surface from kernel/kernel#1306: PATCH /auth/connections/{id} update endpoint, sign_in_options input type, sso_provider submit field, configurable health_check_interval, and 6 new error codes
  • Adds re-auth trigger FAQ entry (content from Managed auth re-authentication trigger #246), submit field reference table, and CUA capability descriptions
  • Applies sentence case to H2+ headings per style guide

Files changed

  • profiles/managed-auth/overview.mdx — CUA description, update endpoint section, removed beta notice
  • profiles/managed-auth/programmatic.mdx — sign_in_options, sso_provider, submit field reference table, error codes section
  • profiles/managed-auth/hosted-ui.mdx — health_check_interval config, heading case fixes
  • profiles/managed-auth/faq.mdx — re-auth trigger, health check config, error codes table, CUA site support, update endpoint FAQ
  • profiles/credentials.mdx — minor SSO wording update

Notes

Test plan

  • Verify Mintlify preview renders all MDX correctly
  • Confirm code examples are syntactically valid for TypeScript and Python
  • Cross-check new API fields against kernel/kernel#1306 OpenAPI spec changes
  • Verify internal doc links resolve correctly

🤖 Generated with Claude Code

Reflects the migration from programmatic DOM-based auth to CUA (Computer Use Agent)
that visually navigates login pages. Key changes:

- Describe CUA-based approach in overview (screenshot-based visual navigation)
- Add new sign_in_options input type for account/org selection in programmatic flow
- Add sso_provider as recommended SSO submit method (vs sso_button_selector)
- Document PATCH /auth/connections/{id} update endpoint
- Add configurable health_check_interval (300-86400s)
- Document new error codes: domain_not_allowed, network_error,
  unsupported_auth_method, awaiting_input_timeout, external_action_timeout,
  max_steps_exceeded
- Add re-auth trigger FAQ entry
- Add submit field reference table
- Fix heading case to sentence case per style guide

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.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