---
title: "POST /startDICOMImportJob/datastore/{datastoreId}"
method: POST
path: "/startDICOMImportJob/datastore/{datastoreId}"
---

# POST /startDICOMImportJob/datastore/{datastoreId}

`POST /startDICOMImportJob/datastore/{datastoreId}`

Start importing bulk data into an <code>ACTIVE</code> data store. The import job imports DICOM P10 files or enhances existing DICOM files with JSON metadata. The <code>importConfiguration</code> parameter specifies the import type. The data is found in the S3 prefix specified by the <code>inputS3Uri</code> parameter. The import job stores processing results in the file specified by the <code>outputS3Uri</code> parameter.

## Path parameters

- `datastoreId` string, required

## Request body

- object
  - `jobName` string — The import job name.
  - `dataAccessRoleArn` string, required — The Amazon Resource Name (ARN) of the IAM role that grants permission to access medical imaging resources.
  - `clientToken` string, required — A unique identifier for API idempotency.
  - `inputS3Uri` string, required — The input prefix path for the S3 bucket that contains the DICOM files to be imported.
  - `outputS3Uri` string, required — The output prefix of the S3 bucket to upload the results of the DICOM import job.
  - `inputOwnerAccountId` string — The account ID of the source S3 bucket owner.
  - `importConfiguration` object — The configuration options for different types of import operations.
    - `dicomJsonMetadataImportConfiguration` DicomJsonMetadataImportConfiguration — The configuration parameters that are specific to DICOM JSON metadata import operations.
      - `dicomMetadataMappings` DicomMetadataMapping[], required — Maps DCM files to their metadata.
        - `studyInstanceUID` string, password, required — The Study Instance UID that identifies the study.
        - `seriesInstanceUID` string, password — The Series Instance UID that identifies the series. This parameter is optional because the mapping might be at the study level.
        - `metadataFilePath` string, required — The path to the JSON metadata file relative to inputS3Uri.

## Response `200`

Success

- StartDICOMImportJobResponse
  - `datastoreId` string, required — The data store identifier.
  - `jobId` string, required — The import job identifier.
  - `jobStatus` 'SUBMITTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required — The import job status.
  - `submittedAt` string, date-time, required — The timestamp when the import job was submitted.

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