---
title: "POST /datastore/{datastoreId}/imageSet/{imageSetId}/updateImageSetMetadata#latestVersion"
method: POST
path: "/datastore/{datastoreId}/imageSet/{imageSetId}/updateImageSetMetadata#latestVersion"
---

# POST /datastore/{datastoreId}/imageSet/{imageSetId}/updateImageSetMetadata#latestVersion

`POST /datastore/{datastoreId}/imageSet/{imageSetId}/updateImageSetMetadata#latestVersion`

Update image set metadata attributes.

## Path parameters

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

## Query parameters

- `latestVersion` string, required
- `force` boolean
- `includeStudyImageSets` boolean

## Request body

- object
  - `updateImageSetMetadataUpdates` object, required — Contains DICOMUpdates.
    - `DICOMUpdates` object — The object containing <code>removableAttributes</code> and <code>updatableAttributes</code>.
      - `removableAttributes` string, password — The DICOM tags to be removed from <code>ImageSetMetadata</code>.
      - `updatableAttributes` string, password — The DICOM tags that need to be updated in <code>ImageSetMetadata</code>.
    - `revertToVersionId` string — <p>Specifies the previous image set version ID to revert the current image set back to.</p> <note> <p>You must provide either <code>revertToVersionId</code> or <code>DICOMUpdates</code> in your request. A <code>ValidationException</code> error is thrown if both parameters are provided at the same time.</p> </note>

## Response `200`

Success

- UpdateImageSetMetadataResponse
  - `datastoreId` string, required — The data store identifier.
  - `imageSetId` string, required — The image set identifier.
  - `latestVersionId` string, required — The latest 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 image set metadata was created.
  - `updatedAt` string, date-time — The timestamp when image set metadata was updated.
  - `message` string — The error message thrown if an update image set metadata action fails.

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