Sign in

v97

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31135175384.2 KB
Managed Auth

Start login flow

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

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.

Example request

{
  "record_session": true
}

Response

Login flow started

idstring required

Auth connection ID

flow_type'LOGIN' | 'REAUTH' required

Type of login flow started

hosted_urlstring uri required

URL to redirect user to for login

flow_expires_atstring date-time required

When the login flow expires

handoff_codestring

One-time code for handoff (internal use)

live_view_urlstring uri

Browser live view URL for watching the login flow

Example response

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