If you are using Amazon Lex V2, refer to the Amazon Lex V2 guide instead.
If you are using Amazon Lex V1, we recommend upgrading your bots to Amazon Lex V2. We are no longer adding new features to V1 and strongly recommend using V2 for all new bots.
DeleteIntent
Deletes all versions of the intent, including the
$LATEST version. To delete a specific version of the
intent, use the DeleteIntentVersion operation.
You can delete a version of an intent only if it is not referenced. To delete an intent that is referred to in one or more bots (see Amazon Lex: How It Works), you must remove those references first.
Note
If you get the ResourceInUseException exception, it
provides an example reference that shows where the intent is referenced.
To remove the reference to the intent, either update the bot or delete
it. If you get the same exception when you attempt to delete the intent
again, repeat until the intent has no references and the call to
DeleteIntent is successful.
This operation requires permission for the
lex:DeleteIntent action.
Request Syntax
DELETE /intents/name HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- name
-
The name of the intent. The name is case sensitive.
Length Constraints: Minimum length of 1. Maximum length of 100.
Pattern:
^([A-Za-z]_?)+$Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 204
Response Elements
If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.
Errors
- BadRequestException
-
The request is not well formed. For example, a value is invalid or a required field is missing. Check the field values, and try again.
HTTP Status Code: 400
- ConflictException
-
There was a conflict processing the request. Try your request again.
HTTP Status Code: 409
- InternalFailureException
-
An internal Amazon Lex error occurred. Try your request again.
HTTP Status Code: 500
- LimitExceededException
-
The request exceeded a limit. Try your request again.
HTTP Status Code: 429
- NotFoundException
-
The resource specified in the request was not found. Check the resource and try again.
HTTP Status Code: 404
- ResourceInUseException
-
The resource that you are attempting to delete is referred to by another resource. Use this information to remove references to the resource that you are trying to delete.
The body of the exception contains a JSON object that describes the resource.
{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,"resourceReference": {"name": string, "version": string } }HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
