Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Subreddit Rules

Fetch verified or live Reddit subreddit rules for a paid Rankhog workspace. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/rules

Fetch verified or live Reddit subreddit rules for a paid Rankhog workspace. Cache policy: cached. 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/rules" \  -H "Content-Type: application/json" \  -d '{    "managedRedditAccountId": "mra_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo",    "subreddit": "SaaS"  }'
{  "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:rules:read"      ]    },    "message": "Missing required OAuth scope: rankhog:read, reddit:rules: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 Agentic Workspaces POST

List paid Rankhog workspaces and identifiers available to the authenticated actor. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Get Subreddit Activity POST

Return cached subreddit activity and optionally refresh it through the paired Rankhog Desktop browser. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.