Settings

Update article automation settings

Changed on

Update the team's article automation settings. All fields optional; only provided fields change. Toggle automation on/off, set postingFrequency (e.g. daily/weekly), preferredPostingTime (a named window - past-midnight/morning/afternoon/evening/night - or an exact 24h "HH:MM"), timeZone (IANA zone, e.g. "Asia/Kolkata", that posting times resolve against), preferredTopicIds, preferredArticleTypes, content length (short/medium/long), CMS target, image styles, and auto-update rules.

patch/v3/settings/article-automation

Request

  • Base URL: https://api.snowseo.com
  • URL: https://api.snowseo.com/v3/settings/article-automation
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

teamIdstring
automationboolean
postingFrequencystring
preferredPostingTimestring
timeZonestring
targetPostStatus'draft' | 'published'
preferredTopicIdsstring[]
preferredArticleTypesstring[]
preferredContentLength'short' | 'medium' | 'long'
preferredCMSProviderstring nullable
writingLanguagestring nullable

Language code articles are written in (e.g. 'es'). Usually two letters; Chinese is 'zh_CN'/'zh_TW' and Hebrew is 'iw'. Null clears it back to inheriting the brand language. Applies to articles only - keyword research, SERP data and AI-visibility tracking stay on the brand language.

useHumanizerboolean
internalLinkVolumenumber
keepTableOfContentsboolean

Keep the generated table of contents when publishing. Default false - most CMS themes render their own, so ours goes out as a duplicate.

autoUpdateExistingArticlesboolean
articleUpdateFrequencystring
articleUpdateMinAgeDaysnumber

Response

Default Response

successboolean
messagestring

Changes