List Planned Reddit Actions
List a workspace's planned Reddit actions, newest first: by default the open work the control pane counts (blocked, in progress, planned, ready), or...
List a workspace's planned Reddit actions, newest first: by default the open work the control pane counts (blocked, in progress, planned, ready), or the statuses and approval status you ask for. Each item carries its card (opportunityId) and blockedReason; 25 a page (limit up to 100), the next page with nextCursor. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.
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/list" \ -H "Content-Type: application/json" \ -d '{ "managedRedditAccountId": "mra_2x9rnkhdemo", "organizationId": "org_2x9rnkhdemo", "websiteId": "site_2x9rnkhdemo", "limit": 25, "status": [ "blocked" ] }'{ "items": [ { "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": "blocked", "strategyLane": null, "targetKeyword": null, "targetSubreddit": "SaaS", "targetUrl": null, "updatedAt": "2026-06-17T11:45:00.000Z", "websiteId": "site_2x9rnkhdemo", "blockedReason": "awaiting_reddit_account" } ], "nextCursor": 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", "productId": "site_demo", "subscriptionStatus": "past_due" }, "message": "This product has no active plan or trial yet. Call get_product_setup with productId site_demo: it gives the link where the person starts the 7-day trial. Never pay for them." }}{ "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." }}