# Unpublish a changelog

Unpublishes a changelog, removing it from public view.

### Optional Fields

- locales - Array of locales to unpublish from. An empty array unpublishes from all locales

### Behavior

- The changelog content is preserved (reverts to draft state)
- Any scheduled publishes for the specified locales are cancelled
- The changelog can be re-published later

### Response

Returns a success confirmation:

json
{
  "success": true,
  "state": "unpublished"
}


### Errors

- 400 - Invalid changelog ID format
- 404 - Changelog not found or doesn't belong to your organization

Endpoint: POST /v2/changelogs/{id}/unpublish
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Path parameters:

  - `id` (string, required)
    Changelog unique identifier
    Example: "507f1f77bcf86cd799439011"

## Request fields (application/json):

  - `locales` (array)
    An array of locales to unpublish the changelog from. An empty array unpublishes from all locales.
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

## Response 200 fields (application/json):

  - `success` (boolean, required)
    Indicates the operation was successful
    Enum: true

  - `state` (string)
    The state of the changelog after the operation
    Enum: "published", "scheduled", "unpublished"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "changelog_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404