ANanchorbrowser
Identities

Start Dynamic Auth Flow

Changed on

Starts (or restarts) a dynamic auth flow in an existing browser session. session_id is required in the path. Advances until the next presentation (decision, form, detection_failed, authenticated, or failed).

If the response is detection_failed with retryable: true, or the request times out, keep polling GET /v1/identities/dynamic/state/{session_id} — some login steps take longer than a single start/resolve call. If detection_failed and retryable is false, open live_view_url to finish signing in. Do not treat a timeout as a hard stop until view.type is failed or detection_failed and retryable is false.

post/v1/identities/dynamic/start/{session_id}

Request

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

Path parameters

session_idstring required

Active browser session that will drive the login.

Request body

urlstring uri required

Landing URL to open in the session (login page).

hoststring required

Hostname of url. Must match the URL hostname after normalization.

Example request

{
  "url": "https://example.com/login",
  "host": "example.com"
}

Response

First presentation of the auth flow

OR
OR
OR
OR

Changes