---
title: "Change the workspace's article settings. Only the fields you pass change; the rest keep their values. flexibleScheduling true allows 1 to 5 articles a day and lets you move planned articles by hand. styleSet picks the image style for hero images. get_article_settings shows the current values."
method: POST
path: "/api/v1/settings/articles"
---

# Change the workspace's article settings. Only the fields you pass change; the rest keep their values. flexibleScheduling true allows 1 to 5 articles a day and lets you move planned articles by hand. styleSet picks the image style for hero images. get_article_settings shows the current values.

`POST /api/v1/settings/articles`

## Request

- Base URL: `https://api.rctrl.com`
- URL: `https://api.rctrl.com/api/v1/settings/articles`
- Auth: HTTP bearer

Requires the `manage:org` scope.

## Request body

- object
  - `articleSettings` object: The article settings to change. Fields you leave out stay as they are.
    - `autoPublish` boolean: Publish automatically on each article's scheduled day. False: you review and publish each one yourself. News and trending articles always wait for your approval.
    - `autoGenerate` boolean: Off = fully manual mode: articles are written only on demand (generate_article) and publish only from the editor. Turning it on needs a publishing destination that has already put at least one article live on the site.
    - `includeInfographics` boolean: AI hero + section images
    - `titleInHeroImage` boolean: Write the post title into the hero image
    - `includeSectionInfographics` boolean: Informational panels in 2,000+ word articles
    - `includeRelatedReading` boolean: Related Reading link block at the end
    - `includeYouTube` boolean: A relevant YouTube video embedded where a walkthrough would help
    - `useEmojis` boolean: Tasteful emojis in headers and lists
    - `internalLinksPerArticle` number: Links to your own pages in each article (1 to 8)
    - `externalLinksPerArticle` number: Links to other sites in each article (0 to 15)
    - `globalInstructions` string: Editorial rules for every article, like "Always mention our free migration service."
  - `flexibleScheduling` boolean: true allows 1 to 5 articles a day and lets you move planned articles by hand
  - `styleSet` 'editorial' | 'cinematic' | 'documentary' | 'studio' | 'conceptual-metaphor' | 'editorial-illustration' | 'clay-3d' | 'isometric' | 'line-art-minimal' | 'dark-gradient-glass' | 'travel-poster' | 'watercolor-wash' | 'retro-futurism' | 'ukiyo-e' | 'paper-diorama' | 'gouache-metaphor' | 'minimalist' | 'riso-print' | 'pop-art' | 'corporate-flat' | 'memphis' | 'bauhaus-poster' | 'flat-vector' | 'cartoon-creator' | 'soft-anime': Your workspace's image style, one of the 25 styles.

## Response `200`

Success; the payload is wrapped in a data envelope

- object
  - `data` unknown

## Other responses

- `400`: Bad input
- `401`: Missing or invalid API key
- `403`: API key lacks the required scope
- `404`: Not found in this workspace
- `429`: Rate limited; the body includes a retryAfterMs hint

---

[API](https://skmtc.dev/rctrl/apis/rankcontrol-api.md) · [All operations](https://skmtc.dev/rctrl/apis/rankcontrol-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rctrl/apis/rankcontrol-api/revisions/98ecd236394a?raw)