ONonkernel
Managed Auth

Start login flow

Changed on

Starts a login flow for the auth connection. Returns immediately with a hosted URL for the user to complete authentication, or triggers automatic re-auth if credentials are stored.

post/auth/connections/{id}/login

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/auth/connections/{id}/login
  • Auth
    HTTP bearer

Path parameters

idstring required

Auth connection ID

Request body

record_sessionboolean

Override the connection's default for recording this login's browser session. When omitted, the connection's record_session default is used.

skill_mode'enabled' | 'disabled'

Controls whether this login reads and writes learned domain skills. Automatic reauths inherit the selected mode until a later accepted login sets enabled or omits this field. Defaults to enabled when omitted.

Example request

{
  "record_session": true
}

Response

Login flow started

flow_expires_atstring date-time required

When the login flow expires

flow_type'LOGIN' | 'REAUTH' required

Type of login flow started

handoff_codestring

One-time code for handoff (internal use)

hosted_urlstring uri required

URL to redirect user to for login

idstring required

Auth connection ID

live_view_urlstring uri

Browser live view URL for watching the login flow

Example response

{
  "flow_expires_at": "2025-11-05T20:00:00Z",
  "flow_type": "LOGIN",
  "handoff_code": "aBcD123EfGh456IjKl789MnOp012QrStUvWxYzAbCdEf",
  "hosted_url": "https://auth.kernel.com/login/abc123xyz",
  "id": "ma_abc123xyz",
  "live_view_url": "https://live.onkernel.com/abc123xyz"
}

Changes

  • 9d6785128a5eRevision changes
    • info

      added the new us-west enum value to the request property /

  • d0ad464764f9Revision changes
    • info

      added the new optional request property //

    • info

      added the new optional request property /