[akxue]

context

managed auth connections have a hitl setting. when it's on and a login hits a CAPTCHA the login browser can't get past, the login pauses at AWAITING_HUMAN_INTERVENTION so a person can complete the check in the live view, then resumes from the page they left. without it the login fails with captcha_blocked. the API reference already covers the new field, step and choice type, since it's generated from the spec. the guides didn't mention any of it.

changes

• configuration: a "human verification for CAPTCHAs" section with create examples in TS, Python and Go. it covers when the pause applies (interactive logins, including CAPTCHAs in front of the login form; never automatic reauth), the 10 minute wait per pause, the timeout error, and the note shown on repeat pauses. adds hitl to the update table.
• programmatic: how to handle the pause yourself: show live_view_url, then submit the human_intervention choice with the current interaction_id. covers the 400 for any other submit at this step, repeat pauses, the timeout, and allowing the live view origin in frame-src. adds the step and choice type to the reference lists.
• connection lifecycle: the pre-task auth check also stops on AWAITING_HUMAN_INTERVENTION and sends the user to hosted_url. the captcha_blocked row and recovery advice mention hitl.
• react: a short section on the embedded live view, the frame-src requirement and the 0.6.0 minimum. HumanInterventionStep is added to the list of exported components.
• hosted UI: one line for the CAPTCHA step in the user's walkthrough.

testing

• checked behavior and wording against the API spec, the workflow code, the @onkernel/managed-auth-react 0.6.0 source, and the Go and Python SDK types (field names in the Go examples match kernel-go-sdk).
• mint broken-links passes, and the five pages load in mint dev with no MDX errors. i didn't look at the rendered pages in a browser, and the code examples weren't run.
• no changelog entry in this PR.

[mintlify]

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

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Nov 10, 2026, 2:01 AM

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