Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Planned Reddit Action

Return one planned Reddit action from a paid workspace. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/planned-actions/get

Return one planned Reddit action from a paid workspace. Cache policy: live. 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

application/json

application/json

curl -X POST "https://example.com/agent/v1/planned-actions/get" \  -H "Content-Type: application/json" \  -d '{    "managedRedditAccountId": "mra_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo",    "websiteId": "site_2x9rnkhdemo",    "plannedRedditActionId": "act_2x9planned"  }'
{  "actionType": "post",  "approvalNote": null,  "approvalResolvedAt": null,  "approvalStatus": "not_required",  "brief": "Share a first-hand activation lesson with r/SaaS.",  "createdAt": "2026-06-17T11:45:00.000Z",  "dependsOnPlannedRedditActionId": null,  "dueAt": null,  "generatedDraft": "# What actually improved your SaaS activation?\n\nWe recently found that one guided setup step worked better than a long checklist.",  "id": "act_2x9planned",  "intent": "helpful_answer",  "managedRedditAccountId": "mra_2x9rnkhdemo",  "opportunityId": null,  "organizationId": "org_2x9rnkhdemo",  "pausedAt": null,  "priority": 50,  "redditAccountId": null,  "scheduledEndAt": null,  "scheduledStartAt": "2026-06-17T12:00:00.000Z",  "status": "ready",  "strategyLane": null,  "targetKeyword": null,  "targetSubreddit": "SaaS",  "targetUrl": null,  "updatedAt": "2026-06-17T11:45:00.000Z",  "websiteId": "site_2x9rnkhdemo"}
{  "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_paid_plan_required",    "details": {      "managedAccountBillingStatus": "active",      "subscriptionStatus": "past_due"    },    "message": "Rankhog agentic capabilities are available only for active or trialing paid workspaces."  }}

{  "error": {    "code": "agentic_missing_scope",    "details": {      "missingScopes": [        "rankhog:read"      ]    },    "message": "Missing required scope: rankhog:read."  }}

{  "error": {    "code": "agentic_managed_account_not_found",    "message": "Managed Reddit account not found."  }}

{  "error": {    "code": "agentic_internal_error",    "message": "Rankhog could not complete this agentic request."  }}

Get Opportunity POST

Return one Rankhog opportunity with public-safe evidence, blocker remediation, timing, outcome, and linked action summary. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Get Opportunity Conversation POST

Read one opportunity's conversation timeline: milestones, drafts, questions, and messages. Poll with afterSeq for new items. Every current opportunity has a conversation; preserved legacy history can return a null conversationId when no old thread exists. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.