Skip to main content
POST

Authorizations

anchor-api-key
string
header
required

API key passed in the header

Path Parameters

session_id
string
required

Session whose auth flow to advance.

Body

application/json

Body depends on the last view.type. Use the decision shape or the form shape — not both.

option_index
integer
required

Index into that form's options list.

Required range: x >= 0
Example:

0

values
object
required

Map of input name → value for the selected option (options[option_index].inputs lists the names).

Example:

Response

Next presentation of the auth flow

Presentation returned by start/resolve. GET /state nests the same object as view when there is something to show. Discriminated on type. Call /resolve only for decision or form.

session_id
string
required
host
string
required

Hostname the flow was started for.

current_step_label
string
required

Human-readable label of the current login step.

step_id
string
required

Identifier of the current login step.

cdp_url
string
required

CDP websocket URL of the session driving the login.

live_view_url
string
required

URL to watch or take over the session in a browser.

type
enum<string>
required
Available options:
decision
options
object[]
required

Each item is { step_id, label, automatable }. POST /resolve with { "choice": "<step_id>" }.

discovery_error
string

Set when automatic step detection hit an error. A partial flow may still be presented.