> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anchorbrowser.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Access guide

> 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




## OpenAPI

````yaml /openapi.yaml get /v1/agent-access
openapi: 3.1.0
info:
  title: AnchorBrowser API
  version: 1.0.0
  description: APIs to manage all browser-related actions and configuration.
servers:
  - url: https://api.anchorbrowser.io
    description: API server
security: []
paths:
  /v1/agent-access:
    get:
      tags:
        - Agent Access
      summary: Agent Access guide
      description: >
        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
      responses:
        '200':
          description: Ordered flow. Follow `next`.
          content:
            application/json:
              schema:
                type: object
                required:
                  - purpose
                  - docs
                  - credits
                  - ttl_seconds
                  - limits
                  - flow
                  - identity
                  - next
                properties:
                  purpose:
                    type: string
                    description: What Agent Access is for.
                  docs:
                    type: string
                    description: Human-readable guide URL.
                  credits:
                    type: object
                    required:
                      - anonymous
                      - with_identity
                    properties:
                      anonymous:
                        type: number
                        description: >-
                          Credits when onboarding without verified-email
                          identity.
                      with_identity:
                        type: number
                        description: >-
                          Credits when POST includes identity_token with
                          verified email.
                  ttl_seconds:
                    type: number
                    description: Challenge token TTL in seconds.
                  limits:
                    type: object
                    required:
                      - session_max_duration_minutes
                    properties:
                      session_max_duration_minutes:
                        type: number
                        description: >-
                          Maximum session duration in minutes for keys issued
                          through Agent Access.
                  flow:
                    type: array
                    description: >-
                      All onboarding steps in order. For the immediate action,
                      prefer next.
                    items:
                      type: object
                      required:
                        - step
                        - method
                        - path
                        - why
                      properties:
                        step:
                          type: number
                          description: Order in the onboarding sequence.
                        method:
                          type: string
                          enum:
                            - GET
                            - POST
                          description: HTTP method for this step.
                        path:
                          type: string
                          description: Path for this step.
                        why:
                          type: string
                          description: Why this step exists.
                  next:
                    $ref: '#/components/schemas/AgentAccessNextStep'
                  identity:
                    type: object
                    required:
                      - optional
                      - extra_credits
                      - submit
                      - oidc
                    properties:
                      optional:
                        type: boolean
                        description: Whether identity_token is optional on POST.
                      extra_credits:
                        type: number
                        description: Credits granted with verified-email identity_token.
                      submit:
                        type: string
                        description: How to pass identity_token on POST.
                      oidc:
                        type: array
                        description: Supported OIDC identity providers.
                        items:
                          type: object
                          required:
                            - provider
                            - issuer
                            - how
                          properties:
                            provider:
                              type: string
                              description: Provider alias (google, github, vercel).
                            issuer:
                              type: string
                              description: Expected JWT iss claim.
                            how:
                              type: string
                              description: How to obtain a token from this provider.
        '429':
          description: Too many requests from this source.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentAccessError'
      security: []
components:
  schemas:
    AgentAccessNextStep:
      type: object
      required:
        - method
        - path
        - description
      properties:
        method:
          type: string
          enum:
            - GET
            - POST
          description: HTTP method for the next call in the Agent Access onboarding flow.
        path:
          type: string
          description: >-
            Path on https://api.anchorbrowser.io for the next call. Prepend the
            method to execute it.
        description:
          type: string
          description: >-
            Plain-language instruction for what to do on the next call and what
            you receive afterward.
    AgentAccessError:
      type: object
      required:
        - error
        - next
        - docs
      properties:
        error:
          type: string
          description: Why the request failed.
        next:
          $ref: '#/components/schemas/AgentAccessNextStep'
        docs:
          type: string
          description: Human-readable guide URL for Agent Access.
          example: https://docs.anchorbrowser.io/quickstart/agent-access

````