> ## Documentation Index
> Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Article Automation
> Read and configure a brand's automated article generation and publishing settings.
Read a brand's article-automation configuration — posting cadence, preferred topics and article types, content length, image settings, CMS target, and auto-update rules.
Reading requires any team **member**. The `GET` route auto-creates default settings on first read and prunes any stored image styles or article types that are no longer part of the supported set.
### Key fields
| Field | Description |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `automation` | Master on/off switch for automated generation. |
| `postingFrequency` | Cadence for publishing new articles (e.g. `daily`). |
| `targetPostStatus` | `draft` or `published` — status articles are created with. |
| `preferredTopicIds` | Topic-cluster ids the planner may use. Empty = "Any". |
| `preferredArticleTypes` | Article-type ids the planner may use. Empty = "Any". |
| `useHumanizer` | Run generated text through the humanizer. |
| `optionalSections` | Toggle `faq`, `conclusion`, `cta`, `tldr`, `videos` sections. |
| `preferredContentLength` | `short`, `medium`, or `long`. |
| `preferredCMSProvider` | Default CMS to publish to, or `null`. |
| `connectedCmsProviders` | Read-only: the brand's connected CMS providers. |
| `writingLanguage` | Language code articles are written in (e.g. `es`), or `null` to inherit the brand's default language. Usually two letters; Chinese is `zh_CN`/`zh_TW` and Hebrew is `iw`. Articles only — keyword research, SERP data, and AI-visibility tracking stay on the brand language. |
| `internalLinkVolume` | Internal links per 1k words: `3`, `6`, or `9`. |
| `defaultImageProvider` | `ai`, `stock`, or `null` (no images). |
| `featuredImageStyles` | Pool of AI featured-image styles to draw from. |
| `customFeaturedImageReferenceUrl` | Reference image URL when using the `custom` style. |
| `featuredImageText` | Allow text in AI featured images. |
| `featuredImageIncludeBrandColors` | Use brand colors in AI featured images. |
| `featuredImageIncludeBrandLogo` | Include the brand logo in AI featured images. |
| `inArticleImageStyles` | Styles for AI in-article images. |
| `autoUpdateExistingArticles` | Periodically refresh stale published articles. |
| `articleUpdateFrequency` | Cadence for auto-updates (e.g. `every-14-days`). |
| `articleUpdateMinAgeDays` | Min article age before eligible: `7`, `14`, `30`, `60`, or `90`. |
***
## Update Article Automation
`PATCH /v3/settings/article-automation`
Update any subset of the fields above. Only the keys you send are changed.
Writing requires **managed** (admin/owner) access to the brand.
`preferredCMSProvider` must be one of the brand's **connected** integrations, or the request returns `400`. `preferredTopicIds`, `preferredArticleTypes`, and the image-style arrays are filtered to known/owned values, so unsupported entries are silently dropped. An unrecognized `postingFrequency` is coerced to `daily`; changing the cadence re-spaces pending content-planner rows. An unrecognized `writingLanguage` code is ignored; send an explicit `null` to clear it back to the brand's default language.
Changing `writingLanguage` only affects articles created **after** the change. Each article records the language it was written in, so existing articles keep theirs when they are refreshed, audited, or edited.
***
## List Automation Clusters
`GET /v3/settings/article-automation/clusters`
Return the brand's topic clusters for the automation topic picker. Each item has `id`, `name`, and `keywordCount`. Requires any team **member**.