---
title: "POST /knowledgeBases/{knowledgeBaseId}/importJobs"
method: POST
path: "/knowledgeBases/{knowledgeBaseId}/importJobs"
---

# POST /knowledgeBases/{knowledgeBaseId}/importJobs

`POST /knowledgeBases/{knowledgeBaseId}/importJobs`

Start an asynchronous job to import Amazon Q in Connect resources from an uploaded source file. Before calling this API, use [StartContentUpload](https://docs.aws.amazon.com/wisdom/latest/APIReference/API_StartContentUpload.html) to upload an asset that contains the resource data.

*   For importing Amazon Q in Connect quick responses, you need to upload a csv file including the quick responses. For information about how to format the csv file for importing quick responses, see [Import quick responses](https://docs.aws.amazon.com/console/connect/quick-responses/add-data).

## Path parameters

- `knowledgeBaseId` string, required

## Request body

- object
  - `importJobType` 'QUICK_RESPONSES', required — <p>The type of the import job.</p> <ul> <li> <p>For importing quick response resource, set the value to <code>QUICK_RESPONSES</code>.</p> </li> </ul>
  - `uploadId` string, required — A pointer to the uploaded asset. This value is returned by <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_StartContentUpload.html">StartContentUpload</a>.
  - `clientToken` string — The tags used to organize, track, or control access for this resource.
  - `metadata` object — The metadata fields of the imported Amazon Q in Connect resources.
  - `externalSourceConfiguration` object — The configuration information of the external data source.
    - `source` 'AMAZON_CONNECT' — The type of the external data source.
    - `configuration` object — The configuration information of the external data source.
      - `connectConfiguration` object — The configuration information of the Amazon Connect data source.
        - `instanceId` string — The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

## Response `200`

Success

- StartImportJobResponse
  - `importJob` object — The import job.
    - `importJobId` string, required — The identifier of the import job.
    - `knowledgeBaseId` string, required — The identifier of the knowledge base.
    - `uploadId` string, required — A pointer to the uploaded asset. This value is returned by <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_StartContentUpload.html">StartContentUpload</a>.
    - `knowledgeBaseArn` string, required — The Amazon Resource Name (ARN) of the knowledge base.
    - `importJobType` 'QUICK_RESPONSES', required — The type of the import job.
    - `status` 'START_IN_PROGRESS' | 'FAILED' | 'COMPLETE' | 'DELETE_IN_PROGRESS' | 'DELETE_FAILED' | 'DELETED', required — The status of the import job.
    - `url` string, password, required — The download link to the resource file that is uploaded to the import job.
    - `failedRecordReport` string, password — The link to download the information of resource data that failed to be imported.
    - `urlExpiry` string, date-time, required — The expiration time of the URL as an epoch timestamp.
    - `createdTime` string, date-time, required — The timestamp when the import job was created.
    - `lastModifiedTime` string, date-time, required — The timestamp when the import job data was last modified.
    - `metadata` object — The metadata fields of the imported Amazon Q in Connect resources.
    - `externalSourceConfiguration` ExternalSourceConfiguration — The configuration information of the external data source.
      - `source` 'AMAZON_CONNECT', required — The type of the external data source.
      - `configuration` object, required — The configuration information of the external data source.
        - `connectConfiguration` object — The configuration information of the Amazon Connect data source.
          - `instanceId` string — The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

## Other responses

- `480` — ConflictException
- `481` — ValidationException
- `482` — ServiceQuotaExceededException
- `483` — UnauthorizedException
- `484` — AccessDeniedException
- `485` — ResourceNotFoundException

---

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