Agent Access

Create Agent Access project

Changed on

Issue an Agent Access API key. Submit the challenge token and computed integer answer from GET /v1/agent-access/challenge. GET on this path returns a guide, not a key. Optional identity_token as an OIDC JWT grants more credits. identity_provider is optional when the JWT iss is Google (https://accounts.google.com), GitHub Actions (https://token.actions.githubusercontent.com), or Vercel (https://vercel.com). Returns api_key for header anchor-api-key. Docs: https://docs.anchorbrowser.io/quickstart/agent-access

post/v1/agent-access

Request

  • Base URL
    https://api.anchorbrowser.io
  • Auth
    none required

Request body

tokenstring required

Token returned by GET /v1/agent-access/challenge. Not the puzzle answer.

answerstring required

Final integer from the challenge prompt, as a string.

identity_providerstring

Optional when identity_token is an OIDC JWT whose iss matches a known provider (google, github, or vercel). Required for opaque OAuth access tokens (google or github).

identity_tokenstring

OIDC JWT preferred (iss auto-detected). GitHub Actions — GET $ACTIONS_ID_TOKEN_REQUEST_URL with Authorization bearer $ACTIONS_ID_TOKEN_REQUEST_TOKEN. Google — ID token JWT. Vercel — Sign in with Vercel user ID token (iss https://vercel.com). Opaque OAuth access tokens also work with identity_provider set.

identity_audiencestring

Optional. Pin the JWT aud claim. Omit unless you requested a specific aud.

Response

API key issued. Follow next to make an authenticated call.

api_keystring required

API key for authenticated requests. Send as header anchor-api-key.

project_idstring required

Anchor project id created or reused for this onboarding.

credits_grantednumber required

Credits added by this POST. 0 when the Agent Access project already existed for this owner.

agent_identity_tokenstring

When present, send as header anchor-identity-token on later API calls when auth.identity_token_required is true.

docsstring required

Human-readable guide URL for Agent Access.

Changes