---
title: "POST /datastore/{datastoreId}/imageSet/{sourceImageSetId}/copyImageSet"
method: POST
path: "/datastore/{datastoreId}/imageSet/{sourceImageSetId}/copyImageSet"
---

# POST /datastore/{datastoreId}/imageSet/{sourceImageSetId}/copyImageSet

`POST /datastore/{datastoreId}/imageSet/{sourceImageSetId}/copyImageSet`

Copy an image set.

## Path parameters

- `datastoreId` string, required
- `sourceImageSetId` string, required

## Query parameters

- `force` boolean
- `promoteToPrimary` boolean

## Request body

- object
  - `copyImageSetInformation` object, required — Copy image set information.
    - `sourceImageSet` object — The source image set.
      - `latestVersionId` string, required — The latest version identifier for the source image set.
      - `DICOMCopies` object — Contains <code>MetadataCopies</code> structure and wraps information related to specific copy use cases. For example, when copying subsets.
        - `copiableAttributes` string, password, required — The JSON string used to specify a subset of SOP Instances to copy from source to destination image set.
    - `destinationImageSet` object — The destination image set.
      - `imageSetId` string, required — The image set identifier for the destination image set.
      - `latestVersionId` string, required — The latest version identifier for the destination image set.

## Response `200`

Success

- CopyImageSetResponse
  - `datastoreId` string, required — The data store identifier.
  - `sourceImageSetProperties` object, required — The properties of the source image set.
    - `imageSetId` string, required — The image set identifier for the copied source image set.
    - `latestVersionId` string, required — The latest version identifier for the copied source image set.
    - `imageSetState` 'ACTIVE' | 'LOCKED' | 'DELETED' — The image set state of the copied source image set.
    - `imageSetWorkflowStatus` 'CREATED' | 'COPIED' | 'COPYING' | 'COPYING_WITH_READ_ONLY_ACCESS' | 'COPY_FAILED' | 'UPDATING' | 'UPDATING_FOR_STUDY_CONSISTENCY' | 'UPDATED' | 'UPDATE_FAILED' | 'DELETING' | 'DELETED' | 'IMPORTING' | 'IMPORTED' | 'IMPORT_FAILED' — The workflow status of the copied source image set.
    - `createdAt` string, date-time — The timestamp when the source image set properties were created.
    - `updatedAt` string, date-time — The timestamp when the source image set properties were updated.
    - `imageSetArn` string — The Amazon Resource Name (ARN) assigned to the source image set.
  - `destinationImageSetProperties` object, required — The properties of the destination image set.
    - `imageSetId` string, required — The image set identifier of the copied image set properties.
    - `latestVersionId` string, required — The latest version identifier for the destination image set properties.
    - `imageSetState` 'ACTIVE' | 'LOCKED' | 'DELETED' — The image set state of the destination image set properties.
    - `imageSetWorkflowStatus` 'CREATED' | 'COPIED' | 'COPYING' | 'COPYING_WITH_READ_ONLY_ACCESS' | 'COPY_FAILED' | 'UPDATING' | 'UPDATING_FOR_STUDY_CONSISTENCY' | 'UPDATED' | 'UPDATE_FAILED' | 'DELETING' | 'DELETED' | 'IMPORTING' | 'IMPORTED' | 'IMPORT_FAILED' — The image set workflow status of the destination image set properties.
    - `createdAt` string, date-time — The timestamp when the destination image set properties were created.
    - `updatedAt` string, date-time — The timestamp when the destination image set properties were last updated.
    - `imageSetArn` string — The Amazon Resource Name (ARN) assigned to the destination image set.

## Other responses

- `480` — ThrottlingException
- `481` — ConflictException
- `482` — AccessDeniedException
- `483` — ValidationException
- `484` — InternalServerException
- `485` — ResourceNotFoundException
- `486` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/medical-imaging.md) · [All operations](https://skmtc.net/aws/apis/medical-imaging/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/medical-imaging/versions/a4a282481097/schema)