---
title: "Unpublish an article"
method: PUT
path: "/api/articles/{id}/unpublish"
tags: ["articles"]
---

# Unpublish an article

`PUT /api/articles/{id}/unpublish`

This endpoint allows the client to unpublish an article.

The user associated with the API key must have any 'admin' or 'moderator' role.

The article will be unpublished and will no longer be visible to the public. It will remain
in the database and will set back to draft status on the author's posts dashboard. Any
notifications associated with the article will be deleted. Any comments on the article
will remain.

## Path parameters

- `id` integer, required

## Query parameters

- `note` string

## Response `204`

Article successfully unpublished

## Other responses

- `401` — Unauthorized
- `404` — Article Not Found

## Changes

> 59 revisions in range; 6 could not be searched.

- **2026-07-13** (v1) `189b62b952ea` — 2 breaking
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
- **2026-07-13** (v1) `7db6ba099285` — 2 breaking
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
- **2026-05-28** (v1) `6550ad7be94f` — 2 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `404`
- **2026-03-03** (v1) `c9e7662755c2` — 2 breaking
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
- **2023-12-18** (v1) `1c81594090c0` — 2 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `404`

[Full history](https://skmtc.dev/forem/apis/forem-api-v1/changes/api/articles/:id/unpublish/put.md)

---

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