---
title: "POST /datastore/{datastoreId}/imageSet/{imageSetId}/listImageSetVersions"
method: POST
path: "/datastore/{datastoreId}/imageSet/{imageSetId}/listImageSetVersions"
---

# POST /datastore/{datastoreId}/imageSet/{imageSetId}/listImageSetVersions

`POST /datastore/{datastoreId}/imageSet/{imageSetId}/listImageSetVersions`

List image set versions.

## Path parameters

- `datastoreId` string, required
- `imageSetId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListImageSetVersionsResponse
  - `imageSetPropertiesList` ImageSetProperties[], required — Lists all properties associated with an image set.
    - `imageSetId` string, required — The image set identifier.
    - `versionId` string, required — The image set version identifier.
    - `imageSetState` 'ACTIVE' | 'LOCKED' | 'DELETED', required — The image set state.
    - `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.
    - `createdAt` string, date-time — The timestamp when the image set properties were created.
    - `updatedAt` string, date-time — The timestamp when the image set properties were updated.
    - `deletedAt` string, date-time — The timestamp when the image set properties were deleted.
    - `message` string — The error message thrown if an image set action fails.
    - `overrides` object — Contains details on overrides used when creating the returned version of an image set. For example, if <code>forced</code> exists, the <code>forced</code> flag was used when creating the image set.
      - `forced` boolean — Providing this parameter will force completion of the <code>CopyImageSet</code> and <code>UpdateImageSetMetadata</code> actions, even if metadata is inconsistent at the Patient, Study, and/or Series levels.
    - `isPrimary` boolean — The flag to determine whether the image set is primary or not.
  - `nextToken` string — The pagination token used to retrieve the list of image set versions on the next page.

## Other responses

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

---

[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)