v1

latestOpenAPI 3.1.02026-07-2295105298.6 KB
Content

Start Content Pipeline

Start the content pipeline in one of four modes — draft (write new content from promptIds), snipe (outrank a competitor url), optimize (improve an existing url for AI search), slice (split one url into several articles). Required fields by mode: draft needs promptIds (resolve real prompt ids first — via prompts.selectForDraft in chat, or get_prompts / GET /v1/prompts over MCP and the API; never invent ids) AND title; snipe needs url AND title; optimize needs url AND title; slice needs url (and must NOT include promptIds). Returns durable contentIds (job handles); poll get_content_status (content.pipeline.status) per id. Credit op; requires approval.

post/api/v1/content/generate

Request body

website_idstring required
mode'draft' | 'snipe' | 'optimize' | 'slice' required
titlestring
urlstring
prompt_idsstring[]
custom_instructionsstring
brand_kit_idstring
sheet_idstring nullable
use_content_memoriesboolean
auto_approveboolean
content_format_typestring
scrape_additional_linksboolean
kb_mode'auto' | 'manual' | 'none'
selected_topic_idsstring[]
pinned_claim_idsstring[]
use_kb_internal_linksboolean
rec_idstring
rec_kind'on_page_topic' | 'on_page_snipe'
pdf_file_name_or_r2_keystring

Response

Success

content_idsstring[] required
status'generating' required
slice_titlesstring[]