---
title: "Update an article"
method: PATCH
path: "/articles/{id}"
tags: ["Articles"]
---

# Update an article

`PATCH /articles/{id}`

## Request

- Base URL: `https://api.screvi.com/api/v1`
- URL: `https://api.screvi.com/api/v1/articles/{id}`
- Auth: API key in header `X-API-Key`

Triage and metadata edits. `home_status` moves the article between the inbox, Later and the archive, exactly as the app does. `tags` replaces the tag set. The article body is not editable: it is shared between everyone who saved the same page. Requires the `write` scope.

## Request body

- object
  - `home_status` 'inbox' | 'later' | 'archive'
  - `favorite` boolean
  - `title` string, nullable
  - `excerpt` string, nullable
  - `note` string, nullable
  - `tags` string[]

## Response `200`

The updated article

## Other responses

- `404`: Not found
- `422`: Validation failed

---

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