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

# POST /imports/

`POST /imports/`

Lists the imports for a bot, bot locale, or custom vocabulary. Imports are kept in the list for 7 days.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `botId` string — The unique identifier that Amazon Lex assigned to the bot.
  - `botVersion` string — The version of the bot to list imports for.
  - `sortBy` object — Provides information for sorting a list of imports.
    - `attribute` 'LastUpdatedDateTime' — The export field to use for sorting.
    - `order` 'Ascending' | 'Descending' — The order to sort the list.
  - `filters` ImportFilter[] — Provides the specification of a filter used to limit the bots in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.
    - `name` 'ImportResourceType', required — The name of the field to use for filtering.
    - `values` FilterValue[], required — The values to use to filter the response. The values must be <code>Bot</code>, <code>BotLocale</code>, or <code>CustomVocabulary</code>.
    - `operator` 'CO' | 'EQ', required — The operator to use for the filter. Specify EQ when the <code>ListImports</code> operation should return only resource types that equal the specified value. Specify CO when the <code>ListImports</code> operation should return resource types that contain the specified value.
  - `maxResults` integer — The maximum number of imports to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  - `nextToken` string — <p>If the response from the <code>ListImports</code> operation contains more results than specified in the <code>maxResults</code> parameter, a token is returned in the response.</p> <p>Use the returned token in the <code>nextToken</code> parameter of a <code>ListImports</code> request to return the next page of results. For a complete set of results, call the <code>ListImports</code> operation until the <code>nextToken</code> returned in the response is null.</p>
  - `localeId` string — Specifies the locale that should be present in the list. If you don't specify a resource type in the <code>filters</code> parameter, the list contains both bot locales and custom vocabularies.

## Response `200`

Success

- ListImportsResponse
  - `botId` string — The unique identifier assigned by Amazon Lex to the bot.
  - `botVersion` string — The version of the bot that was imported. It will always be <code>DRAFT</code>.
  - `importSummaries` ImportSummary[] — Summary information for the imports that meet the filter criteria specified in the request. The length of the list is specified in the <code>maxResults</code> parameter. If there are more imports available, the <code>nextToken</code> field contains a token to get the next page of results.
    - `importId` string — The unique identifier that Amazon Lex assigned to the import.
    - `importedResourceId` string — The unique identifier that Amazon Lex assigned to the imported resource.
    - `importedResourceName` string — The name that you gave the imported resource.
    - `importStatus` 'InProgress' | 'Completed' | 'Failed' | 'Deleting' — The status of the resource. When the status is <code>Completed</code> the resource is ready to build.
    - `mergeStrategy` 'Overwrite' | 'FailOnConflict' | 'Append' — The strategy used to merge existing bot or bot locale definitions with the imported definition.
    - `creationDateTime` string, date-time — The date and time that the import was created.
    - `lastUpdatedDateTime` string, date-time — The date and time that the import was last updated.
    - `importedResourceType` 'Bot' | 'BotLocale' | 'CustomVocabulary' — The type of resource that was imported.
  - `nextToken` string — A token that indicates whether there are more results to return in a response to the <code>ListImports</code> operation. If the <code>nextToken</code> field is present, you send the contents as the <code>nextToken</code> parameter of a <code>ListImports</code> operation request to get the next page of results.
  - `localeId` string — The locale specified in the request.

## Other responses

- `480` — ThrottlingException
- `481` — ValidationException
- `482` — InternalServerException

---

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