ANanchorbrowser
Browser Sessions

Start Browser Session (async)

Changed on

Non-blocking variant of POST /v1/sessions. Returns a request_id immediately and provisions the underlying browser pod in the background. Poll GET /v1/sessions/async/{request_id}/status until status becomes ready to obtain the resolved session_id, cdp_url and live_view_url.

post/v1/sessions/async

Request

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

Request body

identity_skip_validationboolean

When true (default), skip profile validation for active identities and reuse the saved browser profile. Set to false to validate the profile and re-authenticate if it is no longer signed in. Pending identities still authenticate on first use.

identity_async_authboolean

Run identity authentication in the background and return the session immediately.

Example request

{
  "session": {
    "tags": [
      "production",
      "scraping",
      "customer-123"
    ],
    "domain_allowlist": [
      "example.com",
      "example.org"
    ]
  },
  "integrations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "1PASSWORD",
      "configuration": {
        "load_mode": "all"
      }
    }
  ],
  "identities": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Response

Async session creation accepted; poll the status endpoint to resolve.

Changes