Skip to main content
POST
/
agents
/
auth
/
runs
/
{run_id}
/
discover
JavaScript
import Kernel from '@onkernel/sdk';

const client = new Kernel({
  apiKey: 'My API Key',
});

const agentAuthDiscoverResponse = await client.agents.auth.runs.discover('run_id');

console.log(agentAuthDiscoverResponse.success);
{
  "success": true,
  "logged_in": true,
  "login_url": "https://example.com/login",
  "fields": [
    {
      "name": "email",
      "type": "email",
      "label": "Email address",
      "placeholder": "you@example.com",
      "required": true,
      "selector": "input#email"
    }
  ],
  "page_title": "Sign In",
  "error_message": "No form fields found"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
run_id
string
required

Run ID

Body

application/json · object

Request to discover login fields

Response

Discovery completed successfully with fields found

Response from discover endpoint matching AuthBlueprint schema

​
success
boolean
required

Whether discovery succeeded

​
logged_in
boolean

Whether user is already logged in

​
login_url
string<uri>

URL of the discovered login page

Example:

"https://example.com/login"

​
fields
object[]

Discovered form fields (present when success is true)

​
page_title
string

Title of the login page

Example:

"Sign In"

​
error_message
string

Error message if discovery failed

Example:

"No form fields found"