Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kernel Managed Auth API

Create and manage auth connections for automated credential capture and login.

Kernel Managed Auth API is one of 22 APIs that Kernel publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Managed Auth. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 10 operations across 7 paths, and defines 25 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against a single base URL, https://api.onkernel.com.

10 operations 7 paths 25 schemas 1 DELETE4 GET1 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://api.onkernel.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Kernel Managed Auth API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 10

Across 7 paths, the API surfaces 10 operations — 1 DELETE, 4 GET, 1 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Managed Auth 10

Create and manage auth connections for automated credential capture and login.

POST
/auth/connections
Create auth connection
postAuthConnections body → 201400401403409500
GET
/auth/connections
List auth connections
getAuthConnections 5 params → 200401500
GET
/auth/connections/{id}
Get auth connection
getAuthConnectionsById 1 param → 200401404500
PATCH
/auth/connections/{id}
Update auth connection
patchAuthConnectionsById 1 param body → 200400401404500
DELETE
/auth/connections/{id}
Delete auth connection
deleteAuthConnectionsById 1 param → 204401404500
POST
/auth/connections/{id}/login
Start login flow
postAuthConnectionsLogin 1 param body → 200400401403404409500
POST
/auth/connections/{id}/submit
Submit field values
postAuthConnectionsSubmit 1 param body → 202400401404422500
GET
/auth/connections/{id}/events
Stream login flow events via SSE
getAuthConnectionsEventsById 1 param → 200401404500
GET
/auth/connections/{id}/timeline
Get auth connection event timeline
getAuthConnectionsTimelineById 4 params → 200401404500
POST
/auth/connections/{id}/exchange
Exchange handoff code for JWT
postAuthConnectionsExchange 1 param body → 200400404410500

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are ManagedAuth (36 properties), ManagedAuthStateEvent (18 properties), ManagedAuthTimelineEvent (12 properties), ManagedAuthCreateRequest (11 properties). Each schema is shown below with its type and property counts.

ManagedAuthEvent
Union type representing any managed auth event.
ManagedAuthCreateRequest
object
Request to create an auth connection for a profile and domain
11 properties 2 required
SubmitFieldsRequest
object
Request to submit field values, click an SSO button, select an MFA method, or select a sign-in option. Prefer canonical selectedchoiceid/fieldvalues when the A…
7 properties
SSOButton
object
An SSO button for signing in with an external identity provider
3 properties 3 required
MFAType
string
The MFA delivery method type. Includes 'password' for auth method selection pages and 'switch' for generic method-switcher links like "Use another method" that…
ManagedAuthUpdateRequest
object
Request to update an auth connection's configuration
9 properties
LoginRequest
object
Request to start a login flow
2 properties
ProxyRef
object
Proxy selection. Provide either id or name. The proxy must be in the same project as the resource referencing it. When selecting by name, the name must match e…
2 properties
ManagedAuthField
object
Canonical field awaiting user input.
6 properties 3 required
SubmitFieldsResponse
object
Response from submitting field values
1 property 1 required
ErrorDetail
object
2 properties
Error
object
4 properties 2 required
ErrorEvent
object
An error event from the application.
3 properties 3 required
ManagedAuthTimelineEvent
object
A single event in an auth connection's history — a login attempt, an automatic re-auth attempt, or a health check.
12 properties 4 required
ManagedAuthStateEvent
object
An event representing the current state of a managed auth flow.
18 properties 4 required
ManagedAuthChoice
object
Canonical auth-flow choice awaiting user selection.
5 properties 3 required
DiscoveredField
object
A discovered form field
8 properties 4 required
ManagedAuthExchangeResponse
object
Response from exchange endpoint
2 properties 2 required
SignInOption
object
A non-MFA choice presented during the auth flow (e.g. account selection, org picker)
3 properties 2 required
MFAOption
object
An MFA method option for verification
4 properties 2 required
ManagedAuth
object
Managed authentication that keeps a profile logged into a specific domain. Flow fields (flowstatus, flowstep, discoveredfields, mfaoptions) reflect the most re…
36 properties 6 required
ManagedAuthExchangeRequest
object
Request to exchange handoff code for JWT
1 property 1 required
SSEHeartbeatEvent
object
Heartbeat event sent periodically to keep SSE connection alive.
2 properties 2 required
CredentialReference
object
Reference to credentials for the auth connection. Use one of: - { name } for Kernel credentials - { provider, path } for external provider item - { provider, a…
4 properties
LoginResponse
object
Response from starting a login flow
6 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kernel-managed-auth-api-openapi.yml Raw ↑

Other APIs Kernel publishes across the network.

Kernel API Keys API
Kernel Apps API
Kernel Audit Logs API
Kernel Browser Computer Controls API
Kernel Browser Filesystem API
Kernel Browser Logs API
Kernel Browser Playwright API
Kernel Browser Pools API
Kernel Browser Processes API
Kernel Browser Replays API
Kernel Browser Telemetry API
Kernel Browsers API