---
title: "Edit a delivered article: {title?, markdown?}. html is re-rendered server-side from markdown on every edit (never accepted from the caller). Free."
method: PATCH
path: "/articles/{articleId}"
---

# Edit a delivered article: {title?, markdown?}. html is re-rendered server-side from markdown on every edit (never accepted from the caller). Free.

`PATCH /articles/{articleId}`

## Request

- Base URL: `https://app.seomatic.ai/api/v1`
- URL: `https://app.seomatic.ai/api/v1/articles/{articleId}`
- Auth: HTTP bearer

## Path parameters

- `articleId` string, uuid, required

## Request body

- object
  - `title` string
  - `markdown` string: Full replacement markdown body.

## Response `200`

{ ok: true, id }

## Other responses

- `400`: Neither title nor markdown provided
- `401`: Missing or invalid API key
- `404`: Not found, or article not ready yet (NOT_FOUND)
- `429`: Rate limited (per key). Retry-After header set.

---

[API](https://skmtc.dev/seomatic/apis/seomatic-api.md) · [All operations](https://skmtc.dev/seomatic/apis/seomatic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seomatic/apis/seomatic-api/revisions/113a2a263604?raw)