---
title: "POST /imports/"
method: POST
path: "/imports/"
---

# POST /imports/

`POST /imports/`

Starts a job to import a resource to Amazon Lex.

## Request body

- object
  - `payload` string, required — A zip archive in binary format. The archive should contain one file, a JSON file containing the resource to import. The resource should match the type specified in the <code>resourceType</code> field.
  - `resourceType` 'BOT' | 'INTENT' | 'SLOT_TYPE', required — <p>Specifies the type of resource to export. Each resource also exports any resources that it depends on. </p> <ul> <li> <p>A bot exports dependent intents.</p> </li> <li> <p>An intent exports dependent slot types.</p> </li> </ul>
  - `mergeStrategy` 'OVERWRITE_LATEST' | 'FAIL_ON_CONFLICT', required — <p>Specifies the action that the <code>StartImport</code> operation should take when there is an existing resource with the same name.</p> <ul> <li> <p>FAIL_ON_CONFLICT - The import operation is stopped on the first conflict between a resource in the import file and an existing resource. The name of the resource causing the conflict is in the <code>failureReason</code> field of the response to the <code>GetImport</code> operation.</p> <p>OVERWRITE_LATEST - The import operation proceeds even if there is a conflict with an existing resource. The $LASTEST version of the existing resource is overwritten with the data from the import file.</p> </li> </ul>
  - `tags` Tag[] — A list of tags to add to the imported bot. You can only add tags when you import a bot, you can't add tags to an intent or slot type.
    - `key` string, required — The key for the tag. Keys are not case-sensitive and must be unique.
    - `value` string, required — The value associated with a key. The value may be an empty string but it can't be null.

## Response `201`

Success

- StartImportResponse
  - `name` string — The name given to the import job.
  - `resourceType` 'BOT' | 'INTENT' | 'SLOT_TYPE' — The type of resource to import.
  - `mergeStrategy` 'OVERWRITE_LATEST' | 'FAIL_ON_CONFLICT' — The action to take when there is a merge conflict.
  - `importId` string — The identifier for the specific import job.
  - `importStatus` 'IN_PROGRESS' | 'COMPLETE' | 'FAILED' — The status of the import job. If the status is <code>FAILED</code>, you can get the reason for the failure using the <code>GetImport</code> operation.
  - `tags` Tag[] — A list of tags added to the imported bot.
    - `key` string, required — The key for the tag. Keys are not case-sensitive and must be unique.
    - `value` string, required — The value associated with a key. The value may be an empty string but it can't be null.
  - `createdDate` string, date-time — A timestamp for the date and time that the import job was requested.

## Other responses

- `480` — LimitExceededException
- `481` — InternalFailureException
- `482` — BadRequestException

---

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