Identities

Get Dynamic Auth Flow State

Changed on

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_failed with retryable: 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.

get/v1/identities/dynamic/state/{session_id}

Request

  • Base URL
    https://api.anchorbrowser.io
  • Auth
    API key in header anchor-api-key

Path parameters

session_idstring required

Session whose auth flow state to read.

Response

Current auth flow state

session_idstring required
graph_idinteger required

Internal identifier for this auth flow.

current_step_idstring required

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

discovery_status'in_progress' | 'complete' | 'failed' required

Whether automatic detection of the login steps is still running.

discovery_errorstring
phase'navigating' | 'settled' required

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

updated_atnumber required

Unix epoch milliseconds of the last state change.

Changes