Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Radar Status

Report whether Radar is running for this workspace, what is blocking it, and what it has checked, surfaced and triaged recently. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/strategy/radar/status

Report whether Radar is running for this workspace, what is blocking it, and what it has checked, surfaced and triaged recently. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Authorization

AuthorizationBearer <token>

Rankhog organization API key sent as Authorization: Bearer rhog_....

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/agent/v1/strategy/radar/status" \  -H "Content-Type: application/json" \  -d '{    "organizationId": "org_2x9rnkhdemo",    "websiteId": "site_2x9rnkhdemo"  }'
{  "activity": {    "checkedCount": 1284,    "surfacedCount": 11,    "triagedCount": 8,    "waitingCount": 3,    "windowDays": 7  },  "generatedAt": "2026-06-17T12:00:00.000Z",  "issues": [    {      "code": "desktop_not_connected",      "message": "Rankhog Desktop is not connected. Open it so Radar can write replies for you.",      "severity": "blocking"    }  ],  "state": "blocked"}
{  "error": {    "code": "agentic_invalid_input",    "details": {      "issues": [        {          "code": "invalid_type",          "message": "Expected string, received undefined.",          "path": [            "organizationId"          ]        }      ]    },    "message": "Request body did not match the agentic capability schema."  }}

{  "error": {    "code": "agentic_unauthorized",    "message": "Authenticate before using Rankhog agentic capabilities."  }}

{  "error": {    "code": "agentic_missing_scope",    "details": {      "missingScopes": [        "rankhog:read"      ]    },    "message": "Missing required OAuth scope: rankhog:read."  }}
{  "error": {    "code": "agentic_internal_error",    "message": "Rankhog could not complete this agentic request."  }}

Get Radar Coverage POST

Return current Radar watcher coverage and collector health. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Start Discovery POST

Start Discovery with an optional product direction. Cache policy: live. Idempotency: required. Auth modes: mcp_oauth, session_bearer.