Skip to main content
POST
Create Agent Access project

Body

application/json
token
string
required

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

Minimum string length: 1
answer
string
required

Final integer from the challenge prompt, as a string.

Minimum string length: 1
identity_provider
string

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_token
string

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_audience
string

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_key
string
required

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

project_id
string
required

Anchor project id created or reused for this onboarding.

credits_granted
number
required

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

auth
object
required
next
object
required
docs
string
required

Human-readable guide URL for Agent Access.

limits
object
required
agent_identity_token
string

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

upgrade
object