---
title: "Changes to Create multiple component datasets from a single Multi-Assay ancestor"
method: POST
path: "/datasets/components"
---

# Changes to Create multiple component datasets from a single Multi-Assay ancestor

`POST /datasets/components`

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

## Timeline

Changed in 14 of 84 revisions.

- **2025-03-17** `2fcb1e3c58ae`: 54 warning, 2 info
- **2025-03-17** `79987e9684bb`: 56 info
- **2025-03-12** `e6e7a8247356`: 54 warning, 2 info
- **2025-03-11** `f501fd04e98c`: 15 breaking, 3 warning, 75 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
- **2023-11-07** `a7f2e2b4dce6`: 19 warning, 2 info
- **2023-10-23** `31c2438306d1`: 1 info
- **2023-10-23** `fce4d60839e0`: 1 breaking
- **2023-10-16** `2961e021a912`: 1 info

## Changes

- **2025-03-17** `2fcb1e3c58ae`: 54 warning, 2 info
  - removed the request property `creation_action`
  - removed the request property `datasets`
  - removed the request property `direct_ancestor_uuids`
  - removed the request property `group_uuid`
  - removed the optional property `items/antibodies` from the response with the `200` status
  - removed the optional property `items/calculated_metadata` from the response with the `200` status
  - removed the optional property `items/collections` from the response with the `200` status
  - removed the optional property `items/contacts` from the response with the `200` status
  - removed the optional property `items/contains_human_genetic_sequences` from the response with the `200` status
  - removed the optional property `items/contributors` from the response with the `200` status
  - removed the optional property `items/created_by_user_displayname` from the response with the `200` status
  - removed the optional property `items/created_by_user_email` from the response with the `200` status
  - removed the optional property `items/created_by_user_sub` from the response with the `200` status
  - removed the optional property `items/created_timestamp` from the response with the `200` status
  - removed the optional property `items/creation_action` from the response with the `200` status
  - removed the optional property `items/creators` from the response with the `200` status
  - removed the optional property `items/data_access_level` from the response with the `200` status
  - removed the optional property `items/data_types` from the response with the `200` status
  - removed the optional property `items/dbgap_sra_experiment_url` from the response with the `200` status
  - removed the optional property `items/dbgap_study_url` from the response with the `200` status
  - removed the optional property `items/description` from the response with the `200` status
  - removed the optional property `items/direct_ancestors` from the response with the `200` status
  - removed the optional property `items/doi_url` from the response with the `200` status
  - removed the optional property `items/entity_type` from the response with the `200` status
  - removed the optional property `items/error_message` from the response with the `200` status
  - removed the optional property `items/files` from the response with the `200` status
  - removed the optional property `items/group_name` from the response with the `200` status
  - removed the optional property `items/group_uuid` from the response with the `200` status
  - removed the optional property `items/hubmap_id` from the response with the `200` status
  - removed the optional property `items/ingest_metadata` from the response with the `200` status
  - removed the optional property `items/intended_dataset_type` from the response with the `200` status
  - removed the optional property `items/intended_organ` from the response with the `200` status
  - removed the optional property `items/last_modified_timestamp` from the response with the `200` status
  - removed the optional property `items/last_modified_user_displayname` from the response with the `200` status
  - removed the optional property `items/last_modified_user_email` from the response with the `200` status
  - removed the optional property `items/last_modified_user_sub` from the response with the `200` status
  - removed the optional property `items/local_directory_rel_path` from the response with the `200` status
  - removed the optional property `items/metadata` from the response with the `200` status
  - removed the optional property `items/next_revision_uuid` from the response with the `200` status
  - removed the optional property `items/next_revision_uuids` from the response with the `200` status
  - …16 more
- **2025-03-17** `79987e9684bb`: 56 info
  - added the new optional request property `creation_action`
  - added the new optional request property `datasets`
  - added the new optional request property `direct_ancestor_uuids`
  - added the new optional request property `group_uuid`
  - added the optional property `items/antibodies` to the response with the `200` status
  - added the optional property `items/calculated_metadata` to the response with the `200` status
  - added the optional property `items/collections` to the response with the `200` status
  - added the optional property `items/contacts` to the response with the `200` status
  - added the optional property `items/contains_human_genetic_sequences` to the response with the `200` status
  - added the optional property `items/contributors` to the response with the `200` status
  - added the optional property `items/created_by_user_displayname` to the response with the `200` status
  - added the optional property `items/created_by_user_email` to the response with the `200` status
  - added the optional property `items/created_by_user_sub` to the response with the `200` status
  - added the optional property `items/created_timestamp` to the response with the `200` status
  - added the optional property `items/creation_action` to the response with the `200` status
  - added the optional property `items/creators` to the response with the `200` status
  - added the optional property `items/data_access_level` to the response with the `200` status
  - added the optional property `items/data_types` to the response with the `200` status
  - added the optional property `items/dbgap_sra_experiment_url` to the response with the `200` status
  - added the optional property `items/dbgap_study_url` to the response with the `200` status
  - added the optional property `items/description` to the response with the `200` status
  - added the optional property `items/direct_ancestors` to the response with the `200` status
  - added the optional property `items/doi_url` to the response with the `200` status
  - added the optional property `items/entity_type` to the response with the `200` status
  - added the optional property `items/error_message` to the response with the `200` status
  - added the optional property `items/files` to the response with the `200` status
  - added the optional property `items/group_name` to the response with the `200` status
  - added the optional property `items/group_uuid` to the response with the `200` status
  - added the optional property `items/hubmap_id` to the response with the `200` status
  - added the optional property `items/ingest_metadata` to the response with the `200` status
  - added the optional property `items/intended_dataset_type` to the response with the `200` status
  - added the optional property `items/intended_organ` to the response with the `200` status
  - added the optional property `items/last_modified_timestamp` to the response with the `200` status
  - added the optional property `items/last_modified_user_displayname` to the response with the `200` status
  - added the optional property `items/last_modified_user_email` to the response with the `200` status
  - added the optional property `items/last_modified_user_sub` to the response with the `200` status
  - added the optional property `items/local_directory_rel_path` to the response with the `200` status
  - added the optional property `items/metadata` to the response with the `200` status
  - added the optional property `items/next_revision_uuid` to the response with the `200` status
  - added the optional property `items/next_revision_uuids` to the response with the `200` status
  - …16 more
- **2025-03-12** `e6e7a8247356`: 54 warning, 2 info
  - removed the request property `creation_action`
  - removed the request property `datasets`
  - removed the request property `direct_ancestor_uuids`
  - removed the request property `group_uuid`
  - removed the optional property `items/antibodies` from the response with the `200` status
  - removed the optional property `items/calculated_metadata` from the response with the `200` status
  - removed the optional property `items/collections` from the response with the `200` status
  - removed the optional property `items/contacts` from the response with the `200` status
  - removed the optional property `items/contains_human_genetic_sequences` from the response with the `200` status
  - removed the optional property `items/contributors` from the response with the `200` status
  - removed the optional property `items/created_by_user_displayname` from the response with the `200` status
  - removed the optional property `items/created_by_user_email` from the response with the `200` status
  - removed the optional property `items/created_by_user_sub` from the response with the `200` status
  - removed the optional property `items/created_timestamp` from the response with the `200` status
  - removed the optional property `items/creation_action` from the response with the `200` status
  - removed the optional property `items/creators` from the response with the `200` status
  - removed the optional property `items/data_access_level` from the response with the `200` status
  - removed the optional property `items/data_types` from the response with the `200` status
  - removed the optional property `items/dbgap_sra_experiment_url` from the response with the `200` status
  - removed the optional property `items/dbgap_study_url` from the response with the `200` status
  - removed the optional property `items/description` from the response with the `200` status
  - removed the optional property `items/direct_ancestors` from the response with the `200` status
  - removed the optional property `items/doi_url` from the response with the `200` status
  - removed the optional property `items/entity_type` from the response with the `200` status
  - removed the optional property `items/error_message` from the response with the `200` status
  - removed the optional property `items/files` from the response with the `200` status
  - removed the optional property `items/group_name` from the response with the `200` status
  - removed the optional property `items/group_uuid` from the response with the `200` status
  - removed the optional property `items/hubmap_id` from the response with the `200` status
  - removed the optional property `items/ingest_metadata` from the response with the `200` status
  - removed the optional property `items/intended_dataset_type` from the response with the `200` status
  - removed the optional property `items/intended_organ` from the response with the `200` status
  - removed the optional property `items/last_modified_timestamp` from the response with the `200` status
  - removed the optional property `items/last_modified_user_displayname` from the response with the `200` status
  - removed the optional property `items/last_modified_user_email` from the response with the `200` status
  - removed the optional property `items/last_modified_user_sub` from the response with the `200` status
  - removed the optional property `items/local_directory_rel_path` from the response with the `200` status
  - removed the optional property `items/metadata` from the response with the `200` status
  - removed the optional property `items/next_revision_uuid` from the response with the `200` status
  - removed the optional property `items/next_revision_uuids` from the response with the `200` status
  - …16 more
- **2025-03-11** `f501fd04e98c`: 15 breaking, 3 warning, 75 info
  - request property `datasets/items/allOf[#/components/schemas/Dataset]/collections/items/entity_type` was restricted to a list of enum values
  - request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/entity_type` was restricted to a list of enum values
  - request property `datasets/items/allOf[#/components/schemas/Dataset]/entity_type` was restricted to a list of enum values
  - the `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/image_files_to_remove/items/` request property format changed from `file_uuid` to `uuid`
  - the `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/metadata_files_to_remove/items/` request property format changed from `file_uuid` to `uuid`
  - the `datasets/items/allOf[#/components/schemas/Dataset]/thumbnail_file_to_remove` request property format changed from `file_uuid` to `uuid`
  - the `datasets/items/allOf[#/components/schemas/Dataset]/upload` request property type changed from `array` to `object`
  - the `items/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 `items/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 `items/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 `items/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 `items/thumbnail_file` response's property type changed from no type to `object` for status `200`
  - the `items/thumbnail_file_to_add` response's property format changed from `temp_file_id` to no format for status `200`
  - the `items/thumbnail_file_to_remove` response's property format changed from `file_uuid` to `uuid` for status `200`
  - the `items/upload` response's property type changed from `array` to `object` for status `200`
  - added the new `Collection` enum value to the `items/collections/items/entity_type` response property for the response status `200`
  - added the new `Dataset` enum value to the `items/entity_type` response property for the response status `200`
  - added the new `Sample` enum value to the `items/direct_ancestors/items/anyOf[#/components/schemas/Sample]/entity_type` response property for the response status `200`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/contacts`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/creators`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/description`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/group_uuid`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/image_files_to_add`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/image_files_to_remove`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/lab_donor_id`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/label`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/metadata`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/protocol_url`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor/registered_doi`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/upload/dataset_uuids_to_link`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/upload/dataset_uuids_to_unlink`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/upload/description`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/upload/group_uuid`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/upload/status`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/upload/title`
  - added the new optional request property `datasets/items/allOf[#/components/schemas/Dataset]/upload/validation_message`
  - the request optional property `datasets/items/allOf[#/components/schemas/Dataset]/direct_ancestors/items/anyOf[#/components/schemas/Sample]/direct_ancestor` became not read-only
  - the request optional property `datasets/items/allOf[#/components/schemas/Dataset]/upload` became not read-only
  - added the new `Collection` enum value to the request property `datasets/items/allOf[#/components/schemas/Dataset]/collections/items/entity_type`
  - added the new `Dataset` enum value to the request property `datasets/items/allOf[#/components/schemas/Dataset]/entity_type`
  - …53 more
- **2023-12-07** `baf36099f131`: 2 warning
  - removed the optional property `items/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status
  - removed the optional property `items/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 `items/next_revision_uuids` to the response with the `200` status
  - added the optional property `items/previous_revision_uuids` to the response with the `200` status
- **2023-11-29** `2d0ea8f4f444`: 1 warning, 1 info
  - removed the optional property `items/creation_action_activity` from the response with the `200` status
  - added the optional property `items/creation_action` to the response with the `200` status
- **2023-11-28** `e52647b58e30`: 3 info
  - added the optional property `items/creation_action_activity` to the response with the `200` status
  - added the optional property `items/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` to the response with the `200` status
  - added the optional property `items/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 `items/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type` from the response with the `200` status
  - removed the optional property `items/direct_ancestors/items/anyOf[#/components/schemas/Sample]/specimen_type_other` from the response with the `200` status
  - removed the optional property `items/next_revision_uuids` from the response with the `200` status
  - removed the optional property `items/previous_revision_uuids` from the response with the `200` status
- **2023-11-14** `fceff381ab8a`: 2 info
  - added the optional property `items/next_revision_uuids` to the response with the `200` status
  - added the optional property `items/previous_revision_uuids` to the response with the `200` status
- **2023-11-07** `a7f2e2b4dce6`: 19 warning, 2 info
  - removed the request property `datasets/items/antibodies`
  - removed the request property `datasets/items/contacts`
  - removed the request property `datasets/items/contains_human_genetic_sequences`
  - removed the request property `datasets/items/creators`
  - removed the request property `datasets/items/data_types`
  - removed the request property `datasets/items/dbgap_sra_experiment_url`
  - removed the request property `datasets/items/dbgap_study_url`
  - removed the request property `datasets/items/description`
  - removed the request property `datasets/items/error_message`
  - removed the request property `datasets/items/group_uuid`
  - removed the request property `datasets/items/ingest_metadata`
  - removed the request property `datasets/items/previous_revision_uuid`
  - removed the request property `datasets/items/registered_doi`
  - removed the request property `datasets/items/retraction_reason`
  - removed the request property `datasets/items/status`
  - removed the request property `datasets/items/sub_status`
  - removed the request property `datasets/items/thumbnail_file_to_add`
  - removed the request property `datasets/items/thumbnail_file_to_remove`
  - removed the request property `datasets/items/title`
  - added the new optional request property `datasets/items/$ref`
  - added the new optional request property `datasets/items/dataset_link_abs_dir`
- **2023-10-23** `31c2438306d1`: 1 info
  - endpoint added
- **2023-10-23** `fce4d60839e0`: 1 breaking
  - api path removed without deprecation
- **2023-10-16** `2961e021a912`: 1 info
  - endpoint added

---

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