Plan a thread for a subreddit
POST /api/v1/projects/{project}/reddit/subreddits/{subreddit}/post
Builds a brief for starting a thread there (the rules that bind it, title options, an outline that defines the brand early, what to leave out) and, when an AI provider is set, writes the draft. The draft always discloses that you work on the brand, and the returned checks list what still needs a person. Not for communities whose rules ban self-promotion: it says so instead.
A full-access key (ss_sk_…), or an editor or owner signed in.
Parameters
| Name | Type | Description |
|---|---|---|
project requiredpath |
string | The project's id. |
subreddit requiredpath |
string | The subreddit's id. |
Request body
JSON, sent with Content-Type: application/json.
| Name | Type | Description |
|---|---|---|
kind |
string | story (a post from the team), resource (a guide with data), comparison (an honest comparison) or feedback (asking for opinions). Default story. One of: story resource comparison feedback |
notes |
string up to 2000 characters |
What the thread should be about, in your words, and any real facts to use (numbers, dates, results). |
draft |
boolean | Write the draft as well as the brief (default true; needs an AI provider). |
Returns
{ data: { item: Opportunity, brief, draft: { title, body } | null, checks, ai: boolean } }
Example
curl -X POST "https://sniffington.com/api/v1/projects/{project}/reddit/subreddits/{subreddit}/post" \
-H "Authorization: Bearer $SCOUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"story","notes":"…"}'