Get Dynamic Auth Flow State
Read-only snapshot of an in-progress dynamic auth flow. Does not acquire the flow lock or mutate state.
Poll this endpoint when:
- start/resolve returned
type: detection_failedwithretryable: true(the next login step is still being determined and may take longer than the request timeout) - start/resolve timed out or returned 409 while a transition is in flight
- you need the current presentation without submitting an answer
view is that presentation — the same object start/resolve return. Treat it
as the live step when phase is settled. While phase is navigating,
view may already describe the next step; target is only a progress
label for the in-flight transition.
Keep polling until view.type is decision, form, authenticated, a
non-retryable detection_failed, or a non-retryable failed. Then call
/resolve only for decision/form, /finalize for authenticated, or
open live_view_url for detection_failed.
Authorizations
API key passed in the header
Path Parameters
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.
Internal identifier for this auth flow.
Identifier of the step the flow last committed. While phase is navigating,
view may already describe a later step.
Whether automatic detection of the login steps is still running.
in_progress, complete, failed navigating — a browser transition is in flight; view may already be the next step.
settled — idle at a step; view is that step.
navigating, settled Unix epoch milliseconds of the last state change.
Outcome of the latest navigation operation.
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.
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.
- decision
- form
- detection_failed
- authenticated
- failed

