---
title: "Unpublishes a specific release of the component."
method: DELETE
path: "/releases/{releaseId}"
tags: ["components"]
---

# Unpublishes a specific release of the component.

`DELETE /releases/{releaseId}`

## Request

- Base URL: `https://marketplace-api.mendix.com/v1`
- URL: `https://marketplace-api.mendix.com/v1/releases/{releaseId}`
- Auth: API key in header `Authorization`

Unpublishes a release from Marketplace. This allows component developers to remove releases when needed, either for corrections or for component retirement.

**Supported States:** It is supported for releases in any state (`Draft`, `InReview`, `Declined`, `Published`).

**Authorization:** The user must have access to manage the component. The user is a developer of the component and meets user group rules.

**Special Cases:**
- If the client attempts to unpublish the only remaining release of a non-deprecated component, a `409 Conflict` response is returned. The component must first be deprecated before deleting its last remaining release.
- If the last remaining release of a deprecated component is unpublished, the whole component is automatically unpublished and removed from Marketplace.

## Path parameters

- `releaseId` string, uuid, required

## Response `204`

The release was successfully unpublished. No content is returned.

## Other responses

- `401`: No usable authentication credentials were found. The error message gives additional information.
- `404`: The required item could not be found. The error message provides additional information.
- `409`: The request could not be completed due to a conflict with the current state of the resource. The error message provides additional information.
- `500`: An error occurred during the processing of the request. The error message provides additional information.

---

[API](https://skmtc.dev/mendix/apis/publish-api.md) - [All operations](https://skmtc.dev/mendix/apis/publish-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/publish-api/revisions/2cf1d323f0b8?raw)