---
title: "POST /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/"
method: POST
path: "/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/"
---

# POST /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/

`POST /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/`

Get a list of intents that meet the specified criteria.

## Path parameters

- `botId` string, required
- `botVersion` string, required
- `localeId` string, required

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `sortBy` object — Specifies attributes for sorting a list of intents.
    - `attribute` 'IntentName' | 'LastUpdatedDateTime' — The attribute to use to sort the list of intents.
    - `order` 'Ascending' | 'Descending' — The order to sort the list. You can choose ascending or descending.
  - `filters` IntentFilter[] — Provides the specification of a filter used to limit the intents in the response to only those that match the filter specification. You can only specify one filter and only one string to filter on.
    - `name` 'IntentName', required — The name of the field to use for the filter.
    - `values` FilterValue[], required — The value to use for the filter.
    - `operator` 'CO' | 'EQ', required — The operator to use for the filter. Specify <code>EQ</code> when the <code>ListIntents</code> operation should return only aliases that equal the specified value. Specify <code>CO</code> when the <code>ListIntents</code> operation should return aliases that contain the specified value.
  - `maxResults` integer — The maximum number of intents 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>ListIntents</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>ListIntents</code> request to return the next page of results. For a complete set of results, call the <code>ListIntents</code> operation until the <code>nextToken</code> returned in the response is null.</p>

## Response `200`

Success

- ListIntentsResponse
  - `botId` string — The identifier of the bot that contains the intent.
  - `botVersion` string — The version of the bot that contains the intent.
  - `localeId` string — The language and locale of the intents in the list.
  - `intentSummaries` IntentSummary[] — Summary information for the intents that meet the filter criteria specified in the request. The length of the list is specified in the <code>maxResults</code> parameter of the request. If there are more intents available, the <code>nextToken</code> field contains a token to get the next page of results.
    - `intentId` string — The unique identifier assigned to the intent. Use this ID to get detailed information about the intent with the <code>DescribeIntent</code> operation.
    - `intentName` string — The name of the intent.
    - `description` string — The description of the intent.
    - `parentIntentSignature` string — If this intent is derived from a built-in intent, the name of the parent intent.
    - `inputContexts` InputContext[] — The input contexts that must be active for this intent to be considered for recognition.
      - `name` string, required — The name of the context.
    - `outputContexts` OutputContext[] — The output contexts that are activated when this intent is fulfilled.
      - `name` string, required — The name of the output context.
      - `timeToLiveInSeconds` integer, required — The amount of time, in seconds, that the output context should remain active. The time is figured from the first time the context is sent to the user.
      - `turnsToLive` integer, required — The number of conversation turns that the output context should remain active. The number of turns is counted from the first time that the context is sent to the user.
    - `lastUpdatedDateTime` string, date-time — The timestamp of the date and time that the intent was last updated.
  - `nextToken` string — A token that indicates whether there are more results to return in a response to the <code>ListIntents</code> operation. If the <code>nextToken</code> field is present, you send the contents as the <code>nextToken</code> parameter of a <code>ListIntents</code> operation request to get the next page of results.

## Other responses

- `480` — ThrottlingException
- `481` — ServiceQuotaExceededException
- `482` — ValidationException
- `483` — 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)