Sign in
CMS

Create an article (draft) from a pre-built outline

Create a draft article from an outline you ALREADY have. This does NOT generate the body content, and it cannot invent the outline for you: articleOutline is required and its generateOutlineResponse must be the whole object returned by generate_outline. For a fully AI-written article, prefer generate_article, which produces the outline and the content in one call. Use this only for the step-by-step wizard, where the user reviews the outline first; then call start_article_generation with the returned slug to write the content.

post/v3/cms/articles

Request body

teamIdstring

Team id (falls back to the session's active project).

titlestring required

Article title.

contentstring

Optional markdown body. Leave empty for a draft you will fill via start_article_generation.

type'listicle' | 'comparison' | 'news' | 'review' | 'guide'

Article type. Defaults to listicle. Must match the outline's structure.

status'draft' | 'processing' | 'generated' | 'scheduled' | 'published' | 'failed' | 'manual'
contentArticleTypestring nullable

"pillar" or "cluster" for pillar/cluster content, null/omitted for generic posts.

authorNamestring
topicIdstring required

Required. Id of the team's topic cluster this article belongs to — get it from topic_clusters_list, or create one with create_topic_cluster. The topic name is taken from this cluster (do not pass a free-text topic).

articleOutlineobject required

Outline wrapper consumed by the generator. Shape: { generateOutlineResponse: <the FULL object returned by generate_outline>, outlineAdditionalElements: { targetWordCount:number, _shouldIncludeFAQ:boolean, _shouldIncludeTldr:boolean, _shouldIncludeConclusion:boolean, _shouldIncludeCTA:boolean }, outlineNonEditable: { introduction: { estimated_words:150 }, conclusion?: { estimated_words:150 } }, audience_level:'auto', content_tone?:string }. Do NOT hand-author the outline — obtain it from generate_outline and pass it through unchanged.

internalLinkTargetSlugsstring[]

Slugs of existing SnowSEO articles to link out to (internal links).

internalLinkTargetUrlsstring[]

Absolute http(s) URLs to link out to that are not SnowSEO articles.

languagestring

Language code to write this article in (e.g. 'es'). Usually two letters; Chinese is 'zh_CN'/'zh_TW' and Hebrew is 'iw'. Defaults to the brand's Writing Language, then its brand language. Only pass this when the user asks for a specific language for this one article.

Response

Default Response

Changes