---
title: "Update an article"
method: PATCH
path: "/v3/cms/articles/{slug}"
tags: ["CMS"]
---

# Update an article

`PATCH /v3/cms/articles/{slug}`

## Path parameters

- `slug` string, required

## Request body

- object
  - `teamId` string
  - `content` string
  - `metaData` object
  - `slug` string
  - `status` string
  - `isPublic` boolean
  - `jsonLd` string, nullable
  - `keywords` object[]
    - `keyword` string, required
    - `type` 'primary' | 'secondary', required
  - `prompts` object[]
    - `prompt` string, required
    - `type` 'primary' | 'secondary', required
  - `revisionSource` 'manual'
  - `revisionLabel` string
  - `autoOptimizeState` object
    - `appliedIds` string[]
    - `dismissedIds` string[]
    - `undoData` object

## Response `200`

Default Response

- object
  - `article` object
    - `slug` string
    - `title` string
    - `status` string
    - `isPublic` boolean
    - `updatedAt` string
    - `lastRefreshedAt` string, nullable
    - `cmsSyncDirty` boolean
    - `publishedSnapshot` object, nullable

## Other responses

- `400` — Default Response
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response

## Changes

- **2026-08-27** `fb2ac524c158` — 4 info
  - added the optional property `code` to the response with the `409` status
  - added the optional property `generationKind` to the response with the `409` status
  - added the optional property `generationPhase` to the response with the `409` status
  - added the optional property `lockedFields` to the response with the `409` status
- **2026-08-07** `aa8eaa9e34a0` — 1 warning
  - removed the request property `prompts/items/topic`
- **2026-07-26** `60ff6690f93c` — 5 info
  - added the new optional request property `autoOptimizeState`
  - added the new optional request property `keywords`
  - added the new optional request property `prompts`
  - added the new optional request property `revisionLabel`
  - …1 more

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/cms/articles/:slug/patch.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/6add26eeb5ca/schema)