Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Reddit Action History

Inspect one tenant-scoped Reddit action receipt with immutable origin, lifecycle events, observations, and derived performance. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/reddit-actions/history/get

Inspect one tenant-scoped Reddit action receipt with immutable origin, lifecycle events, observations, and derived performance. 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/reddit-actions/history/get" \  -H "Content-Type: application/json" \  -d '{    "managedRedditAccountId": "mra_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo",    "websiteId": "site_2x9rnkhdemo",    "redditActionId": "ract_2x9rnkhdemo"  }'
{  "action": {    "actionType": "post",    "actorUserId": "user_2x9rnkhdemo",    "backgroundJobId": "job_2x9rnkhdemo",    "body": "A useful post body.",    "browserCommandId": "browser_command_demo",    "contentFingerprint": "sha256-demo",    "createdAt": "2026-06-17T12:00:00.000Z",    "executionMode": "human",    "executionSource": "opportunity_confirmation",    "failureCode": null,    "failureReason": null,    "id": "ract_2x9rnkhdemo",    "latestVisibilityState": "visible",    "nextObservationAt": "2026-06-17T13:00:00.000Z",    "origin": "warmup",    "permalink": "https://www.reddit.com/r/SaaS/comments/abc123/example/",    "redditAccountId": "reddit_2x9rnkhdemo",    "redditParentThingId": null,    "redditRootThingId": "abc123",    "redditTargetThingId": "abc123",    "redditThingFullname": "t3_abc123",    "redditThingId": "abc123",    "redditUsername": "rankhog_demo",    "status": "submitted",    "subreddit": "SaaS",    "submittedAt": "2026-06-17T12:00:00.000Z",    "targetUrl": "https://www.reddit.com/r/SaaS/submit/",    "title": "Example",    "warmupPlanId": "warmup_plan_2x9rnkhdemo"  },  "events": [],  "observations": [],  "performanceSummary": {    "current": null  }}
{  "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",        "reddit:activity:read"      ]    },    "message": "Missing required OAuth scope: rankhog:read, reddit:activity: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."  }}

List Reddit Action History POST

List and filter the immutable Reddit action execution ledger, including creation origin, for one paid Rankhog workspace. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Get Control Pane Analytics Summary POST

Return the cached Rankhog control-pane analytics summary for a paid workspace. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.