REST API for AI agents.

Name: Go2
Author: Go2

Hono on Cloudflare Workers. Bearer-token auth (API key) or OAuth 2.1 access token. Every endpoint accepts agent attribution context — agent_id, agent_run_id, agent_actor_id, agent_tool_call_id — and the /agent-attribution routes give you the answers back.

5-min quickstart Interactive reference OpenAPI JSON Get an API key

Featured endpoints

POST/api/v1/linksCreate a tracked short link. Accepts agent attribution context inline.
GET/api/v1/linksList links for the authenticated org, paginated and searchable.
GET/api/v1/links/{id}Fetch a single link by id.
PATCH/api/v1/links/{id}Update destination, expiry, click limit, targeting, or agent attribution.
DELETE/api/v1/links/{id}Archive a link. Existing redirects return 410.
GET/api/v1/agent-attributionStream of clicks filtered by agent_id / agent_run_id / link_id.
GET/api/v1/agent-attribution/summaryClick rollup grouped by agent_id or agent_run_id.
GET/api/v1/agent-attribution/runsDistinct agent runs with click counts and first/last timestamps.
GET/api/v1/analytics/{linkId}Per-link analytics: geo, device, browser, OS, referrer breakdowns.
POST/api/v1/qrGenerate a QR code (PNG or SVG) for a link.
GET/api/v1/api-keysList API keys for the authenticated organization.
POST/api/v1/api-keysProvision a new API key. Plaintext returned once at creation time.
GET/api/v1/webhooksList outgoing webhook subscriptions.
POST/api/v1/webhooksSubscribe a URL to events such as click, link.created, qr.scanned.
GET/api/v1/usageCurrent-period usage counters: links created, clicks, custom domains.

Three quick recipes

Create a tracked link

Drop into any shell.

curl -X POST https://api.go2.gg/api/v1/links \
  -H "Authorization: Bearer go2_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationUrl": "https://example.com/launch",
    "agentId": "claude-code",
    "agentRunId": "run_2026_04_27_abc"
  }'

Read clicks for a run

Drop into any shell.

curl "https://api.go2.gg/api/v1/agent-attribution?agentRunId=run_2026_04_27_abc" \
  -H "Authorization: Bearer go2_xxx"

List distinct agent runs

Drop into any shell.

curl "https://api.go2.gg/api/v1/agent-attribution/runs" \
  -H "Authorization: Bearer go2_xxx"

Scopes

OAuth tokens issued via the remote MCP flow are scoped. Pass scope="links:read links:write attribution:read" on the authorize endpoint to mint a least-privilege token.

links:readList and read links.
links:writeCreate, update, and archive links.
analytics:readRead per-link click analytics.
attribution:readRead agent attribution streams and rollups.
attribution:writeMutate agent attribution metadata on links.
webhooks:readList webhook subscriptions.
webhooks:writeManage webhook subscriptions.

Featured endpoints

POST/api/v1/linksCreate a tracked short link. Accepts agent attribution context inline.
GET/api/v1/linksList links for the authenticated org, paginated and searchable.
GET/api/v1/links/{id}Fetch a single link by id.
PATCH/api/v1/links/{id}Update destination, expiry, click limit, targeting, or agent attribution.
DELETE/api/v1/links/{id}Archive a link. Existing redirects return 410.
GET/api/v1/agent-attributionStream of clicks filtered by agent_id / agent_run_id / link_id.
GET/api/v1/agent-attribution/summaryClick rollup grouped by agent_id or agent_run_id.
GET/api/v1/agent-attribution/runsDistinct agent runs with click counts and first/last timestamps.
GET/api/v1/analytics/{linkId}Per-link analytics: geo, device, browser, OS, referrer breakdowns.
POST/api/v1/qrGenerate a QR code (PNG or SVG) for a link.
GET/api/v1/api-keysList API keys for the authenticated organization.
POST/api/v1/api-keysProvision a new API key. Plaintext returned once at creation time.
GET/api/v1/webhooksList outgoing webhook subscriptions.
POST/api/v1/webhooksSubscribe a URL to events such as click, link.created, qr.scanned.
GET/api/v1/usageCurrent-period usage counters: links created, clicks, custom domains.

Three quick recipes

Create a tracked link

Drop into any shell.

curl -X POST https://api.go2.gg/api/v1/links \
  -H "Authorization: Bearer go2_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationUrl": "https://example.com/launch",
    "agentId": "claude-code",
    "agentRunId": "run_2026_04_27_abc"
  }'

Read clicks for a run

Drop into any shell.

curl "https://api.go2.gg/api/v1/agent-attribution?agentRunId=run_2026_04_27_abc" \
  -H "Authorization: Bearer go2_xxx"

List distinct agent runs

Drop into any shell.

curl "https://api.go2.gg/api/v1/agent-attribution/runs" \
  -H "Authorization: Bearer go2_xxx"