---
title: "Removes the content state of a content and publishes a new version."
method: DELETE
path: "/wiki/rest/api/content/{id}/state"
tags: ["Content states"]
---

# Removes the content state of a content and publishes a new version.

`DELETE /wiki/rest/api/content/{id}/state`

Removes the content state of the content specified and creates a new version
(publishes the content without changing the body) of the content with the new status.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to edit the content.

## Path parameters

- `id` string, required

## Query parameters

- `status` 'current' | 'draft'

## Response `200`

Returned if content state is removed from content.

- ContentStateResponse
  - `contentState` ContentState
    - `id` integer, required — identifier of content state. If 0, 1, or 2, this is a default space state
    - `name` string, required — name of content state.
    - `color` string, required — hex string representing color of state
  - `lastUpdated` string — Timestamp of last publish event where content state changed

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `403` — Returned if user does not have content edit permission.
- `404` — Returned if the content with given id can not be found.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/versions/70088490f406/schema)