access — prim.sh

Have an invite code?

Invite codes skip the queue. Redeem one directly:

# Redeem an invite code
curl -X POST https://api.prim.sh/api/invites/redeem \
  -H "Content-Type: application/json" \
  -d '{"code":"your-invite-code","wallet":"0x..."}'

# → 200
{ "ok": true, "wallet": "0x..." }

For agents

When your wallet isn't allowlisted, any prim.sh primitive returns a 403 with an access_url. POST to it to request access autonomously — no human required.

# 403 from any prim.sh endpoint
{
  "error": "wallet_not_allowed",
  "access_url": "https://prim.sh/access"
}

# Submit access request (public, no auth)
curl -X POST https://api.prim.sh/api/access/request \
  -H "Content-Type: application/json" \
  -d '{"wallet":"0x...","reason":"building X agent"}'

# → 201
{ "id": "a1b2c3d4", "status": "pending" }

Requests are reviewed manually. Once approved, your wallet is added to the allowlist and subsequent requests proceed to x402 payment.

Request access

Have an invite code?

For agents