--- title: "Changes to Retrive the latest (newest) revision of a given Dataset. Public/Consortium access rules apply - if no token/consortium access then must be for a public dataset and the returned Dataset must be the latest public version. If the given dataset itself is the latest revision, meaning it has no next revisions, this dataset gets returned." method: GET path: "/datasets/{id}/latest-revision" --- # Changes to Retrive the latest (newest) revision of a given Dataset. Public/Consortium access rules apply - if no token/consortium access then must be for a public dataset and the returned Dataset must be the latest public version. If the given dataset itself is the latest revision, meaning it has no next revisions, this dataset gets returned. `GET /datasets/{id}/latest-revision` > 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`: 50 warning, 2 info - **2025-03-17** `79987e9684bb`: 52 info - **2025-03-12** `e6e7a8247356`: 50 warning, 2 info - **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`: 50 warning, 2 info - removed the optional property `antibodies` from the response with the `200` status - removed the optional property `calculated_metadata` from the response with the `200` status - removed the optional property `collections` from the response with the `200` status - removed the optional property `contacts` from the response with the `200` status - removed the optional property `contains_human_genetic_sequences` from the response with the `200` status - removed the optional property `contributors` from the response with the `200` status - removed the optional property `created_by_user_displayname` from the response with the `200` status - removed the optional property `created_by_user_email` from the response with the `200` status - removed the optional property `created_by_user_sub` from the response with the `200` status - removed the optional property `created_timestamp` from the response with the `200` status - removed the optional property `creation_action` from the response with the `200` status - removed the optional property `creators` from the response with the `200` status - removed the optional property `data_access_level` from the response with the `200` status - removed the optional property `data_types` from the response with the `200` status - removed the optional property `dbgap_sra_experiment_url` from the response with the `200` status - removed the optional property `dbgap_study_url` from the response with the `200` status - removed the optional property `description` from the response with the `200` status - removed the optional property `direct_ancestors` from the response with the `200` status - removed the optional property `doi_url` from the response with the `200` status - removed the optional property `entity_type` from the response with the `200` status - removed the optional property `error_message` from the response with the `200` status - removed the optional property `files` from the response with the `200` status - removed the optional property `group_name` from the response with the `200` status - removed the optional property `group_uuid` from the response with the `200` status - removed the optional property `hubmap_id` from the response with the `200` status - removed the optional property `ingest_metadata` from the response with the `200` status - removed the optional property `intended_dataset_type` from the response with the `200` status - removed the optional property `intended_organ` from the response with the `200` status - removed the optional property `last_modified_timestamp` from the response with the `200` status - removed the optional property `last_modified_user_displayname` from the response with the `200` status - removed the optional property `last_modified_user_email` from the response with the `200` status - removed the optional property `last_modified_user_sub` from the response with the `200` status - removed the optional property `local_directory_rel_path` from the response with the `200` status - removed the optional property `metadata` from the response with the `200` status - removed the optional property `next_revision_uuid` from the response with the `200` status - removed the optional property `next_revision_uuids` from the response with the `200` status - removed the optional property `previous_revision_uuid` from the response with the `200` status - removed the optional property `previous_revision_uuids` from the response with the `200` status - removed the optional property `published_timestamp` from the response with the `200` status - removed the optional property `published_user_displayname` from the response with the `200` status - …12 more - **2025-03-17** `79987e9684bb`: 52 info - added the optional property `antibodies` to the response with the `200` status - added the optional property `calculated_metadata` to the response with the `200` status - added the optional property `collections` to the response with the `200` status - added the optional property `contacts` to the response with the `200` status - added the optional property `contains_human_genetic_sequences` to the response with the `200` status - added the optional property `contributors` to the response with the `200` status - added the optional property `created_by_user_displayname` to the response with the `200` status - added the optional property `created_by_user_email` to the response with the `200` status - added the optional property `created_by_user_sub` to the response with the `200` status - added the optional property `created_timestamp` to the response with the `200` status - added the optional property `creation_action` to the response with the `200` status - added the optional property `creators` to the response with the `200` status - added the optional property `data_access_level` to the response with the `200` status - added the optional property `data_types` to the response with the `200` status - added the optional property `dbgap_sra_experiment_url` to the response with the `200` status - added the optional property `dbgap_study_url` to the response with the `200` status - added the optional property `description` to the response with the `200` status - added the optional property `direct_ancestors` to the response with the `200` status - added the optional property `doi_url` to the response with the `200` status - added the optional property `entity_type` to the response with the `200` status - added the optional property `error_message` to the response with the `200` status - added the optional property `files` to the response with the `200` status - added the optional property `group_name` to the response with the `200` status - added the optional property `group_uuid` to the response with the `200` status - added the optional property `hubmap_id` to the response with the `200` status - added the optional property `ingest_metadata` to the response with the `200` status - added the optional property `intended_dataset_type` to the response with the `200` status - added the optional property `intended_organ` to the response with the `200` status - added the optional property `last_modified_timestamp` to the response with the `200` status - added the optional property `last_modified_user_displayname` to the response with the `200` status - added the optional property `last_modified_user_email` to the response with the `200` status - added the optional property `last_modified_user_sub` to the response with the `200` status - added the optional property `local_directory_rel_path` to the response with the `200` status - added the optional property `metadata` to the response with the `200` status - added the optional property `next_revision_uuid` to the response with the `200` status - added the optional property `next_revision_uuids` to the response with the `200` status - added the optional property `previous_revision_uuid` to the response with the `200` status - added the optional property `previous_revision_uuids` to the response with the `200` status - added the optional property `published_timestamp` to the response with the `200` status - added the optional property `published_user_displayname` to the response with the `200` status - …12 more - **2025-03-12** `e6e7a8247356`: 50 warning, 2 info - removed the optional property `antibodies` from the response with the `200` status - removed the optional property `calculated_metadata` from the response with the `200` status - removed the optional property `collections` from the response with the `200` status - removed the optional property `contacts` from the response with the `200` status - removed the optional property `contains_human_genetic_sequences` from the response with the `200` status - removed the optional property `contributors` from the response with the `200` status - removed the optional property `created_by_user_displayname` from the response with the `200` status - removed the optional property `created_by_user_email` from the response with the `200` status - removed the optional property `created_by_user_sub` from the response with the `200` status - removed the optional property `created_timestamp` from the response with the `200` status - removed the optional property `creation_action` from the response with the `200` status - removed the optional property `creators` from the response with the `200` status - removed the optional property `data_access_level` from the response with the `200` status - removed the optional property `data_types` from the response with the `200` status - removed the optional property `dbgap_sra_experiment_url` from the response with the `200` status - removed the optional property `dbgap_study_url` from the response with the `200` status - removed the optional property `description` from the response with the `200` status - removed the optional property `direct_ancestors` from the response with the `200` status - removed the optional property `doi_url` from the response with the `200` status - removed the optional property `entity_type` from the response with the `200` status - removed the optional property `error_message` from the response with the `200` status - removed the optional property `files` from the response with the `200` status - removed the optional property `group_name` from the response with the `200` status - removed the optional property `group_uuid` from the response with the `200` status - removed the optional property `hubmap_id` from the response with the `200` status - removed the optional property `ingest_metadata` from the response with the `200` status - removed the optional property `intended_dataset_type` from the response with the `200` status - removed the optional property `intended_organ` from the response with the `200` status - removed the optional property `last_modified_timestamp` from the response with the `200` status - removed the optional property `last_modified_user_displayname` from the response with the `200` status - removed the optional property `last_modified_user_email` from the response with the `200` status - removed the optional property `last_modified_user_sub` from the response with the `200` status - removed the optional property `local_directory_rel_path` from the response with the `200` status - removed the optional property `metadata` from the response with the `200` status - removed the optional property `next_revision_uuid` from the response with the `200` status - removed the optional property `next_revision_uuids` from the response with the `200` status - removed the optional property `previous_revision_uuid` from the response with the `200` status - removed the optional property `previous_revision_uuids` from the response with the `200` status - removed the optional property `published_timestamp` from the response with the `200` status - removed the optional property `published_user_displayname` from the response with the `200` status - …12 more - **2025-03-11** `f501fd04e98c`: 8 breaking, 3 warning, 49 info - the `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 `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 `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 `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 `thumbnail_file` response's property type changed from no type to `object` for status `200` - the `thumbnail_file_to_add` response's property format changed from `temp_file_id` to no format for status `200` - the `thumbnail_file_to_remove` response's property format changed from `file_uuid` to `uuid` for status `200` - the `upload` response's property type changed from `array` to `object` for status `200` - added the new `Collection` enum value to the `collections/items/entity_type` response property for the response status `200` - added the new `Dataset` enum value to the `entity_type` response property for the response status `200` - added the new `Sample` enum value to the `direct_ancestors/items/anyOf[#/components/schemas/Sample]/entity_type` response property for the response status `200` - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/contacts` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_by_user_displayname` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_by_user_email` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_by_user_sub` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/created_timestamp` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/creators` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/data_access_level` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/description` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/doi_url` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/entity_type` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/group_name` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/group_uuid` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/hubmap_id` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/image_files` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/lab_donor_id` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/label` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_timestamp` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_user_displayname` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_user_email` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/last_modified_user_sub` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/metadata` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/protocol_url` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/registered_doi` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/submission_id` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/uuid` to the response with the `200` status - added the optional property `upload/created_by_user_displayname` to the response with the `200` status - added the optional property `upload/created_by_user_email` to the response with the `200` status - added the optional property `upload/created_by_user_sub` to the response with the `200` status - added the optional property `upload/created_timestamp` to the response with the `200` status - …20 more - **2023-12-07** `baf36099f131`: 2 warning - removed the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status - removed the optional property `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 `next_revision_uuids` to the response with the `200` status - added the optional property `previous_revision_uuids` to the response with the `200` status - **2023-11-29** `2d0ea8f4f444`: 1 warning, 1 info - removed the optional property `creation_action_activity` from the response with the `200` status - added the optional property `creation_action` to the response with the `200` status - **2023-11-28** `e52647b58e30`: 3 info - added the optional property `creation_action_activity` to the response with the `200` status - added the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` to the response with the `200` status - added the optional property `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 `direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status - removed the optional property `direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status - removed the optional property `next_revision_uuids` from the response with the `200` status - removed the optional property `previous_revision_uuids` from the response with the `200` status - **2023-11-14** `fceff381ab8a`: 2 info - added the optional property `next_revision_uuids` to the response with the `200` status - added the optional property `previous_revision_uuids` to the response with the `200` status --- [Operation](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/docs/datasets/:id/latest-revision/get.md) - [API](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api.md) - [Page](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/changes/datasets/:id/latest-revision/get)