Contents

API reference / Mentions

Draft the answers for the top of the brief

POST /api/v1/brief/drafts

draft_answers Write MCP tool

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.

NameTypeDescription
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":"…"}'