---
title: "Changes to Retracts a dataset after it has been published. Requires a json body with a single field {retraction_reason: string}. The dataset for the given id is modified to include this new retraction_reason field and sets the dataset property sub_status to Retracted. The complete modified dataset is returned. Requires that the dataset being retracted has already been published (dataset.status == Published. Requires a user token with membership in the HuBMAP-Data-Admin group otherwise then a 403 will be returned."
method: PUT
path: "/datasets/{id}/retract"
---

# Changes to Retracts a dataset after it has been published. Requires a json body with a single field {retraction_reason: string}. The dataset for the given id is modified to include this new retraction_reason field and sets the dataset property sub_status to Retracted. The complete modified dataset is returned. Requires that the dataset being retracted has already been published (dataset.status == Published. Requires a user token with membership in the HuBMAP-Data-Admin group otherwise then a 403 will be returned.

`PUT /datasets/{id}/retract`

> Every recorded change to this operation, newest first.
> 64 revisions in range; 12 not diffed.

## Timeline

Changed in 3 of 64 revisions.

- **2025-03-17** `2fcb1e3c58ae`: 1 info
- **2025-03-17** `79987e9684bb`: 1 breaking
- **2025-03-12** `e6e7a8247356`: 1 info

## Changes

- **2025-03-17** `2fcb1e3c58ae`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2025-03-17** `79987e9684bb`: 1 breaking
  - removed the media type `application/json` for the response with the status `200`
- **2025-03-12** `e6e7a8247356`: 1 info
  - added the media type `application/json` for the response with the status `200`

---

[Operation](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/docs/datasets/:id/retract/put.md) - [API](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api.md) - [Page](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/changes/datasets/:id/retract/put)