Rankhog Docs
DocsCLIMCPAPI
API Reference

Create Reddit Post Draft

Create a ready manual Reddit post draft after fetching subreddit rules. Cache policy: live. Idempotency: required. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/drafts

Create a ready manual Reddit post draft after fetching subreddit rules. Cache policy: live. Idempotency: required. 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

application/json

application/json

application/json

curl -X POST "https://example.com/agent/v1/drafts" \  -H "Content-Type: application/json" \  -d '{    "managedRedditAccountId": "mra_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo",    "body": "We replaced a long setup checklist with one guided action and saw activation improve. Curious what other teams changed that made onboarding click.",    "idempotencyKey": "draft-2026-06-17-001",    "riskSummary": "Useful discussion prompt, no link, and includes founder context.",    "subreddit": "SaaS",    "title": "What actually improved your SaaS activation?"  }'
{  "approvalStatus": "not_required",  "approvalUrl": null,  "draftId": "act_2x9rnkhdemo",  "manualStatus": "ready_for_manual_action",  "riskSummary": "Useful discussion prompt, no link, and includes founder context.",  "rules": {    "displayName": "SaaS",    "isVerified": true,    "postingRiskNotes": [      "Avoid launch-only posts and make the post useful without requiring a click."    ],    "rules": [      {        "name": "No spam",        "summary": "Self-promotion must be contextual and useful to the community."      },      {        "name": "Be specific",        "summary": "Posts should include enough detail for founders to respond."      }    ],    "sourceUrls": [      "https://www.reddit.com/r/SaaS/about/rules"    ],    "stats": {      "activeUserCount": 412,      "capturedAt": "2026-06-17T12:00:00.000Z",      "createdUtc": 1262304000,      "publicDescription": "A community for SaaS founders and operators.",      "subscribers": 382000,      "title": "Software as a Service"    },    "status": "ready",    "subreddit": "SaaS",    "url": "https://www.reddit.com/r/SaaS/"  }}
{  "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:draft:write"      ]    },    "message": "Missing required OAuth scope: rankhog:read, reddit:draft:write."  }}

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

{  "error": {    "code": "agentic_managed_account_inactive",    "details": {      "managedAccountStatus": "setup_required"    },    "message": "This managed Reddit account must be active before browser-backed agentic tools can run."  }}

{  "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."  }}
{  "error": {    "code": "agentic_draft_not_created",    "message": "Agent-created Reddit draft could not be stored."  }}

Get Planned Reddit Action POST

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

Create Reddit Action POST

Create a stored Reddit write action for post, comment, reply, upvote, or join_subreddit. Draft approval and write execution remain separate. Cache policy: live. Idempotency: required. Auth modes: api_key, mcp_oauth, session_bearer.