Skip to main content
GET
Get Dynamic Auth Flow State

Authorizations

anchor-api-key
string
header
required

API key passed in the header

Path Parameters

session_id
string
required

Session whose auth flow state to read.

Response

Current auth flow state

Poll this after retryable detection_failed, a request timeout, or 409.

view is the same presentation start/resolve return (type discriminant). When phase is settled, it is the current step. When phase is navigating, it may already describe the next step so you can render (or answer) before the browser finishes moving; it is omitted until there is something to show.

Call /resolve only when view.type is decision or form.

session_id
string
required
graph_id
integer
required

Internal identifier for this auth flow.

current_step_id
string
required

Identifier of the step the flow last committed. While phase is navigating, view may already describe a later step.

discovery_status
enum<string>
required

Whether automatic detection of the login steps is still running.

Available options:
in_progress,
complete,
failed
phase
enum<string>
required

navigating — a browser transition is in flight; view may already be the next step. settled — idle at a step; view is that step.

Available options:
navigating,
settled
updated_at
number
required

Unix epoch milliseconds of the last state change.

nav
object
required

Outcome of the latest navigation operation.

discovery_error
string
target
object

Step the browser is moving toward. Present only while phase is navigating. Use for progress copy (for example "Preparing {label}…"). Not a second presentation — view is what to show.

view
decision · object

What to render or answer. Same shape as start/resolve, derived read-only.

  • phase: settled — the current step.
  • phase: navigating — the upcoming step, when known; omitted until then.