---
title: "Changes to Update the properties of a given Donor, Sample, Dataset or Upload"
method: PUT
path: "/entities/{id}"
---

# Changes to Update the properties of a given Donor, Sample, Dataset or Upload

`PUT /entities/{id}`

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

## Timeline

Changed in 10 of 84 revisions.

- **2025-03-17** `2fcb1e3c58ae`: 1 info
- **2025-03-17** `79987e9684bb`: 1 breaking
- **2025-03-14** `0bfa984e8cdb`: 1 info
- **2025-03-11** `f501fd04e98c`: 3 breaking
- **2023-12-07** `baf36099f131`: 8 warning
- **2023-12-07** `b5ab67c746f7`: 3 info
- **2023-11-29** `2d0ea8f4f444`: 2 warning, 2 info
- **2023-11-28** `e52647b58e30`: 10 info
- **2023-11-21** `ad851942ac27`: 11 warning
- **2023-11-14** `fceff381ab8a`: 3 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-14** `0bfa984e8cdb`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2025-03-11** `f501fd04e98c`: 3 breaking
  - removed `#/components/schemas/Donor, #/components/schemas/Sample, #/components/schemas/Dataset` from the request body `oneOf` list
  - the request's body type changed from no type to `object`
  - removed the media type `application/json` for the response with the status `200`
- **2023-12-07** `baf36099f131`: 8 warning
  - removed the request property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type`
  - removed the request property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other`
  - removed the request property `oneOf[#/components/schemas/Sample]/specimen_type`
  - removed the request property `oneOf[#/components/schemas/Sample]/specimen_type_other`
  - removed the optional property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status
- **2023-12-07** `b5ab67c746f7`: 3 info
  - added the new optional request property `oneOf[#/components/schemas/Dataset]/previous_revision_uuids`
  - added the optional property `oneOf[#/components/schemas/Dataset]/next_revision_uuids` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Dataset]/previous_revision_uuids` to the response with the `200` status
- **2023-11-29** `2d0ea8f4f444`: 2 warning, 2 info
  - removed the request property `oneOf[#/components/schemas/Dataset]/creation_action_activity`
  - removed the optional property `oneOf[#/components/schemas/Dataset]/creation_action_activity` from the response with the `200` status
  - added the new optional request property `oneOf[#/components/schemas/Dataset]/creation_action`
  - added the optional property `oneOf[#/components/schemas/Dataset]/creation_action` to the response with the `200` status
- **2023-11-28** `e52647b58e30`: 10 info
  - added the new optional request property `oneOf[#/components/schemas/Dataset]/creation_action_activity`
  - added the new optional request property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type`
  - added the new optional request property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other`
  - added the new optional request property `oneOf[#/components/schemas/Sample]/specimen_type`
  - added the new optional request property `oneOf[#/components/schemas/Sample]/specimen_type_other`
  - added the optional property `oneOf[#/components/schemas/Dataset]/creation_action_activity` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Sample]/specimen_type` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Sample]/specimen_type_other` to the response with the `200` status
- **2023-11-21** `ad851942ac27`: 11 warning
  - removed the request property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type`
  - removed the request property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other`
  - removed the request property `oneOf[#/components/schemas/Dataset]/previous_revision_uuids`
  - removed the request property `oneOf[#/components/schemas/Sample]/specimen_type`
  - removed the request property `oneOf[#/components/schemas/Sample]/specimen_type_other`
  - removed the optional property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Dataset]/next_revision_uuids` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Dataset]/previous_revision_uuids` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status
- **2023-11-14** `fceff381ab8a`: 3 info
  - added the new optional request property `oneOf[#/components/schemas/Dataset]/previous_revision_uuids`
  - added the optional property `oneOf[#/components/schemas/Dataset]/next_revision_uuids` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Dataset]/previous_revision_uuids` to the response with the `200` status

---

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