Draft the answers for the top of the brief
POST /api/v1/brief/drafts
Writes a reply draft for each of the top posts on the brief that has none yet (default 5, at most 10), for founders' "what to answer today" list and anyone else who answers posts. One model call per draft, only for the posts you ask for, counted against the plan's drafts a day; never run by a scan. Each draft is saved on its mention and comes with `why_this_post`. A post that is a target account's conversation is skipped (use draft_outreach). Nothing is posted: a person posts a reply.
A full-access key (ss_sk_…), or an editor or owner signed in.
Request body
JSON, sent with Content-Type: application/json.
| Name | Type | Description |
|---|---|---|
limit |
integer 1–10 |
How many drafts to write (default 5). |
playbook |
string | A playbook id to take the brief from, instead of the workspace's. |
project |
string | Only this project. |
Returns
{ data: { playbook, drafted: [{ mention_id, draft, why_this_post, ... }], already_drafted, skipped, limits } }
Example
curl -X POST "https://sniffington.com/api/v1/brief/drafts" \
-H "Authorization: Bearer $SCOUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"limit":1,"playbook":"…"}'