---
title: "Agent Access guide"
method: GET
path: "/v1/agent-access"
tags: ["Agent Access"]
---

# Agent Access guide

`GET /v1/agent-access`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/agent-access`
- Auth: none required

Unauthenticated onboarding guide. This GET does **not** issue an API key.
Follow the `next` field: GET `/v1/agent-access/challenge`, solve, then POST `/v1/agent-access`
with `{ token, answer }`. Optional `identity_token` (OIDC JWT) grants more credits.
Docs: https://docs.anchorbrowser.io/quickstart/agent-access

## Response `200`

Ordered flow. Follow `next`.

- object
  - `purpose` string, required: What Agent Access is for.
  - `docs` string, required: Human-readable guide URL.
  - `credits` object, required
    - `anonymous` number, required: Credits when onboarding without verified-email identity.
    - `with_identity` number, required: Credits when POST includes identity_token with verified email.
  - `ttl_seconds` number, required: Challenge token TTL in seconds.
  - `limits` object, required
    - `session_max_duration_minutes` number, required: Maximum session duration in minutes for keys issued through Agent Access.
  - `flow` object[], required: All onboarding steps in order. For the immediate action, prefer next.
    - `step` number, required: Order in the onboarding sequence.
    - `method` 'GET' | 'POST', required: HTTP method for this step.
    - `path` string, required: Path for this step.
    - `why` string, required: Why this step exists.
  - `next` AgentAccessNextStep, required
    - `method` 'GET' | 'POST', required: HTTP method for the next call in the Agent Access onboarding flow.
    - `path` string, required: Path on https://api.anchorbrowser.io for the next call. Prepend the method to execute it.
    - `description` string, required: Plain-language instruction for what to do on the next call and what you receive afterward.
  - `identity` object, required
    - `optional` boolean, required: Whether identity_token is optional on POST.
    - `extra_credits` number, required: Credits granted with verified-email identity_token.
    - `submit` string, required: How to pass identity_token on POST.
    - `oidc` object[], required: Supported OIDC identity providers.
      - `provider` string, required: Provider alias (google, github, vercel).
      - `issuer` string, required: Expected JWT iss claim.
      - `how` string, required: How to obtain a token from this provider.

## Other responses

- `429`: Too many requests from this source.

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/agent-access/get.md)

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) - [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/revisions/9d755f22df0e?raw)