--- title: "Changes to From a given ID of a versioned dataset, retrieve a list of every dataset in the chain ordered from most recent to oldest. The revision number, as well as the dataset uuid will be included. An optional parameter ?include_dataset=true will include the full dataset for each revision as well. Public/Consortium access rules apply, if is for a non-public dataset and no token or a token without membership in HuBMAP-Read group is sent with the request then a 403 response should be returned. If the given id is published, but later revisions are not and the user is not in HuBMAP-Read group, only published revisions will be returned. The field next_revision_uuid will not be returned if the next revision is unpublished" method: GET path: "/datasets/{id}/revisions" --- # Changes to From a given ID of a versioned dataset, retrieve a list of every dataset in the chain ordered from most recent to oldest. The revision number, as well as the dataset uuid will be included. An optional parameter ?include_dataset=true will include the full dataset for each revision as well. Public/Consortium access rules apply, if is for a non-public dataset and no token or a token without membership in HuBMAP-Read group is sent with the request then a 403 response should be returned. If the given id is published, but later revisions are not and the user is not in HuBMAP-Read group, only published revisions will be returned. The field next_revision_uuid will not be returned if the next revision is unpublished `GET /datasets/{id}/revisions` > Every recorded change to this operation, newest first. > 64 revisions in range; 12 not diffed. ## Timeline Changed in 10 of 64 revisions. - **2025-03-17** `2fcb1e3c58ae`: 3 warning - **2025-03-17** `79987e9684bb`: 3 info - **2025-03-12** `e6e7a8247356`: 3 warning - **2025-03-11** `f501fd04e98c`: 8 breaking, 3 warning, 49 info - **2023-12-07** `baf36099f131`: 2 warning - **2023-12-07** `b5ab67c746f7`: 2 info - **2023-11-29** `2d0ea8f4f444`: 1 warning, 1 info - **2023-11-28** `e52647b58e30`: 3 info - **2023-11-21** `ad851942ac27`: 4 warning - **2023-11-14** `fceff381ab8a`: 2 info ## Changes - **2025-03-17** `2fcb1e3c58ae`: 3 warning - removed the optional property `dataset` from the response with the `200` status - removed the optional property `revision_number` from the response with the `200` status - removed the optional property `uuid` from the response with the `200` status - **2025-03-17** `79987e9684bb`: 3 info - added the optional property `dataset` to the response with the `200` status - added the optional property `revision_number` to the response with the `200` status - added the optional property `uuid` to the response with the `200` status - **2025-03-12** `e6e7a8247356`: 3 warning - removed the optional property `dataset` from the response with the `200` status - removed the optional property `revision_number` from the response with the `200` status - removed the optional property `uuid` from the response with the `200` status - **2025-03-11** `f501fd04e98c`: 8 breaking, 3 warning, 49 info - the `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/image_files_to_add/items/` response's property format changed from `temp_file_id` to no format for status `200` - the `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/image_files_to_remove/items/` response's property format changed from `file_uuid` to `uuid` for status `200` - the `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/metadata_files_to_add/items/` response's property format changed from `temp_file_id` to no format for status `200` - the `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/metadata_files_to_remove/items/` response's property format changed from `file_uuid` to `uuid` for status `200` - the `dataset/thumbnail_file` response's property type changed from no type to `object` for status `200` - the `dataset/thumbnail_file_to_add` response's property format changed from `temp_file_id` to no format for status `200` - the `dataset/thumbnail_file_to_remove` response's property format changed from `file_uuid` to `uuid` for status `200` - the `dataset/upload` response's property type changed from `array` to `object` for status `200` - added the new `Collection` enum value to the `dataset/collections/items/entity_type` response property for the response status `200` - added the new `Dataset` enum value to the `dataset/entity_type` response property for the response status `200` - added the new `Sample` enum value to the `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/entity_type` response property for the response status `200` - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/contacts` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_by_user_displayname` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_by_user_email` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_by_user_sub` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_timestamp` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/creators` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/data_access_level` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/description` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/doi_url` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/entity_type` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/group_name` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/group_uuid` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/hubmap_id` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/image_files` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/lab_donor_id` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/label` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_timestamp` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_user_displayname` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_user_email` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_user_sub` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/metadata` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/protocol_url` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/registered_doi` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/submission_id` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/uuid` to the response with the `200` status - added the optional property `dataset/upload/created_by_user_displayname` to the response with the `200` status - added the optional property `dataset/upload/created_by_user_email` to the response with the `200` status - added the optional property `dataset/upload/created_by_user_sub` to the response with the `200` status - added the optional property `dataset/upload/created_timestamp` to the response with the `200` status - …20 more - **2023-12-07** `baf36099f131`: 2 warning - removed the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status - removed the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status - **2023-12-07** `b5ab67c746f7`: 2 info - added the optional property `dataset/next_revision_uuids` to the response with the `200` status - added the optional property `dataset/previous_revision_uuids` to the response with the `200` status - **2023-11-29** `2d0ea8f4f444`: 1 warning, 1 info - removed the optional property `dataset/creation_action_activity` from the response with the `200` status - added the optional property `dataset/creation_action` to the response with the `200` status - **2023-11-28** `e52647b58e30`: 3 info - added the optional property `dataset/creation_action_activity` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` to the response with the `200` status - added the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` to the response with the `200` status - **2023-11-21** `ad851942ac27`: 4 warning - removed the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status - removed the optional property `dataset/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status - removed the optional property `dataset/next_revision_uuids` from the response with the `200` status - removed the optional property `dataset/previous_revision_uuids` from the response with the `200` status - **2023-11-14** `fceff381ab8a`: 2 info - added the optional property `dataset/next_revision_uuids` to the response with the `200` status - added the optional property `dataset/previous_revision_uuids` to the response with the `200` status --- [Operation](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/docs/datasets/:id/revisions/get.md) - [API](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api.md) - [Page](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/changes/datasets/:id/revisions/get)