Rankhog Docs
DocsCLIMCPAPI
API Reference

Stop Discovery

Stop Discovery without changing Radar. Cache policy: live. Idempotency: required. Auth modes: mcp_oauth, session_bearer.

POST
/agent/v1/strategy/discovery/stop

Stop Discovery without changing Radar. Cache policy: live. Idempotency: required. Auth modes: mcp_oauth, session_bearer.

Authorization

AuthorizationBearer <token>

In: header

Scope: rankhog:read, strategy:write

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

application/json

curl -X POST "https://example.com/agent/v1/strategy/discovery/stop" \  -H "Content-Type: application/json" \  -d '{    "organizationId": "org_2x9rnkhdemo",    "websiteId": "site_2x9rnkhdemo",    "idempotencyKey": "stop-discovery-001"  }'
{  "jobId": null,  "strategy": {    "keywords": [      {        "enabled": true,        "id": "kw_1",        "intent": "Compare tools",        "keyword": "Intercom alternative",        "priority": 1      }    ],    "strategy": {      "bootstrap": {        "error": null,        "lastAttemptAt": "2026-06-17T12:00:00.000Z",        "readyAt": "2026-06-17T12:00:00.000Z",        "status": "ready"      },      "discovery": {        "consecutiveEmptyScans": 0,        "direction": "Find support-tool comparison demand",        "lastScanAt": "2026-06-17T12:00:00.000Z",        "lastSuccessAt": "2026-06-17T12:00:00.000Z",        "lastTechnicalError": null,        "nextScanAt": "2026-06-18T07:00:00.000Z",        "sessionId": "session_1",        "status": "running"      },      "id": "strategy_1",      "radarEnabled": true    },    "subreddits": [      {        "enabled": true,        "fitReason": "SaaS operators",        "id": "sub_1",        "priority": 1,        "subreddit": "SaaS",        "verificationStatus": "verified",        "verifiedAt": "2026-06-17T12:00:00.000Z"      }    ],    "timeZone": "Europe/Paris"  }}
{  "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",        "strategy:write"      ]    },    "message": "Missing required OAuth scope: rankhog:read, strategy:write."  }}

{  "error": {    "code": "agentic_write_rate_limited",    "details": {      "limit": 10,      "windowSeconds": 3600    },    "message": "Agentic Reddit writes are rate-limited for this workspace."  }}
{  "error": {    "code": "agentic_internal_error",    "message": "Rankhog could not complete this agentic request."  }}

Start Discovery POST

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

Run Discovery Now POST

Run the active Discovery session now, subject to its hourly limit. Cache policy: live. Idempotency: required. Auth modes: mcp_oauth, session_bearer.