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

# POST /exports/

`POST /exports/`

Lists the exports for a bot, bot locale, or custom vocabulary. Exports 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 exports for.
  - `sortBy` object — Provides information about sorting a list of exports.
    - `attribute` 'LastUpdatedDateTime' — The export field to use for sorting.
    - `order` 'Ascending' | 'Descending' — The order to sort the list.
  - `filters` ExportFilter[] — Provides the specification of a filter used to limit the exports in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.
    - `name` 'ExportResourceType', 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>ListExports</code> operation should return only resource types that equal the specified value. Specify CO when the <code>ListExports</code> operation should return resource types that contain the specified value.
  - `maxResults` integer — The maximum number of exports 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>ListExports</code> operation contains more results that 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>ListExports</code> request to return the next page of results. For a complete set of results, call the <code>ListExports</code> operation until the <code>nextToken</code> returned in the response is null.</p>
  - `localeId` string — Specifies the resources that should be exported. If you don't specify a resource type in the <code>filters</code> parameter, both bot locales and custom vocabularies are exported.

## Response `200`

Success

- ListExportsResponse
  - `botId` string — The unique identifier assigned to the bot by Amazon Lex.
  - `botVersion` string — The version of the bot that was exported.
  - `exportSummaries` ExportSummary[] — Summary information for the exports 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 exports available, the <code>nextToken</code> field contains a token to get the next page of results.
    - `exportId` string — The unique identifier that Amazon Lex assigned to the export.
    - `resourceSpecification` object — Information about the bot or bot locale that was exported.
      - `botExportSpecification` object — Parameters for exporting a bot.
        - `botId` string, required — The identifier of the bot assigned by Amazon Lex.
        - `botVersion` string, required — The version of the bot that was exported. This will be either <code>DRAFT</code> or the version number.
      - `botLocaleExportSpecification` object — Parameters for exporting a bot locale.
        - `botId` string, required — The identifier of the bot to create the locale for.
        - `botVersion` string, required — The version of the bot to export.
        - `localeId` string, required — The identifier of the language and locale to export. The string must match one of the locales in the bot.
      - `customVocabularyExportSpecification` object — The parameters required to export a custom vocabulary.
        - `botId` string, required — The identifier of the bot that contains the custom vocabulary to export.
        - `botVersion` string, required — The version of the bot that contains the custom vocabulary to export.
        - `localeId` string, required — The locale of the bot that contains the custom vocabulary to export.
    - `fileFormat` 'LexJson' | 'TSV' — The file format used in the export files.
    - `exportStatus` 'InProgress' | 'Completed' | 'Failed' | 'Deleting' — The status of the export. When the status is <code>Completed</code> the export is ready to download.
    - `creationDateTime` string, date-time — The date and time that the export was created.
    - `lastUpdatedDateTime` string, date-time — The date and time that the export was last updated.
  - `nextToken` string — A token that indicates whether there are more results to return in a response to the <code>ListExports</code> operation. If the <code>nextToken</code> field is present, you send the contents as the <code>nextToken</code> parameter of a <code>ListExports</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)