AgentRef REST

Use this skill when the user wants to inspect or operate AgentRef over HTTP instead of MCP, especially from OpenClaw or other REST-first runtimes.

Connection contract

• Base URL: https://www.agentref.co/api/v1
• Every request needs Authorization: Bearer <AGENTREF_API_KEY>
• Never print, log, echo, or persist the raw API key in chat output, files, traces, or examples
• Success responses use { data, meta }
• Error responses use { error, meta }
• When a request fails, surface the failing endpoint plus meta.requestId

First request

1. Call GET /api/v1/me
2. Read data.key.ownerType, data.key.keyType, data.key.scopes, and the returned owner/program context
3. If ownerType is affiliate, do not use the merchant-admin endpoints below; say so clearly and only pivot to affiliate /api/v1/me/* reads if the user explicitly wants affiliate self-service