---
title: "POST /builtins/locales/{localeId}/intents/"
method: POST
path: "/builtins/locales/{localeId}/intents/"
---

# POST /builtins/locales/{localeId}/intents/

`POST /builtins/locales/{localeId}/intents/`

Gets a list of built-in intents provided by Amazon Lex that you can use in your bot.

To use a built-in intent as a the base for your own intent, include the built-in intent signature in the `parentIntentSignature` parameter when you call the `CreateIntent` operation. For more information, see [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html).

## Path parameters

- `localeId` string, required

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `sortBy` object — Specifies attributes for sorting a list of built-in intents.
    - `attribute` 'IntentSignature' — The attribute to use to sort the list of built-in intents.
    - `order` 'Ascending' | 'Descending' — The order to sort the list. You can specify ascending or descending order.
  - `maxResults` integer — The maximum number of built-in 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 — If the response from the <code>ListBuiltInIntents</code> operation contains more results than specified in the <code>maxResults</code> parameter, a token is returned in the response. Use that token in the <code>nextToken</code> parameter to return the next page of results.

## Response `200`

Success

- ListBuiltInIntentsResponse
  - `builtInIntentSummaries` BuiltInIntentSummary[] — Summary information for the built-in 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.
    - `intentSignature` string — The signature of the built-in intent. Use this to specify the parent intent of a derived intent.
    - `description` string — The description of the intent.
  - `nextToken` string — A token that indicates whether there are more results to return in a response to the <code>ListBuiltInIntents</code> operation. If the <code>nextToken</code> field is present, you send the contents as the <code>nextToken</code> parameter of a <code>ListBotAliases</code> operation request to get the next page of results.
  - `localeId` string — The language and locale of the intents in the list.

## 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)