API Reference

set opportunity target subreddit

Move a post you started yourself to another community, until its first confirm.

POST
/agent/v1/growth/set-opportunity-target-subreddit

Move a post you started yourself to another community, until its first confirm. Works only on a post started from New or start_conversation (a user-lane reddit_post) that is not closed, has no confirmed draft and no queued or running send; edit the post first to take a confirmed one back. The draft text and revision stay as they are; the submit address is built from the new community at the next confirm. The same community again changes nothing. Never sends or rewrites the draft; an audit verdict from the old community is cleared, so run audit_opportunity_draft for the new one. Refused while a draft is being written. 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

curl -X POST "https://example.com/agent/v1/growth/set-opportunity-target-subreddit" \  -H "Content-Type: application/json" \  -d '{    "organizationId": "org_demo",    "websiteId": "site_demo",    "managedRedditAccountId": "mra_demo",    "idempotencyKey": "growth-request-1",    "opportunityId": "opp_demo",    "subreddit": "SaaS"  }'
{  "changed": true,  "opportunityId": "opp_demo",  "plannedRedditActionId": "act_demo",  "subreddit": "saas",  "title": "Post in r/saas"}
{  "error": {    "code": "agentic_invalid_input",    "message": "Name the community like r/SaaS."  }}
{  "error": {    "code": "agentic_unauthorized",    "message": "Authentication is required."  }}
{  "error": {    "code": "agentic_paid_plan_required",    "message": "An active paid product is required."  }}
{  "error": {    "code": "agentic_missing_scope",    "message": "The required permission has not been granted."  }}
{  "error": {    "code": "agentic_website_not_found",    "message": "Product not found."  }}

{  "error": {    "code": "agentic_post_locked",    "message": "This post is confirmed. Edit it to take it back, then change the community."  }}

{  "error": {    "code": "agentic_write_rate_limited",    "message": "Growth mutations are limited to 120 per actor and organization per hour."  }}