Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-lex:amazon-lex-imports-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.1.0
info:
title: Amazon Lex Model Building V2 Imports API
version: '2020-08-07'
description: Generated from AWS's published Smithy model for Amazon Lex Model Building V2. 4 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://models-v2-lex.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
paths:
/imports/{importId}:
delete:
operationId: DeleteImport
summary: Delete Import
description: Removes a previous import and the associated file stored in an S3 bucket.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteImportResponse'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'412':
description: PreconditionFailedException
content:
application/json:
schema:
$ref: '#/components/schemas/PreconditionFailedException'
'402':
description: ServiceQuotaExceededException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceQuotaExceededException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteImportRequest'
tags:
- Imports
get:
operationId: DescribeImport
summary: Describe Import
description: Gets information about a specific import.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeImportResponse'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeImportRequest'
tags:
- Imports
/imports:
post:
operationId: ListImports
summary: List Imports
description: Lists the imports for a bot, bot locale, or custom vocabulary. Imports are kept in the list for 7 days.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListImportsResponse'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListImportsRequest'
tags:
- Imports
put:
operationId: StartImport
summary: Start Import
description: Starts importing a bot, bot locale, or custom vocabulary from a zip archive that you uploaded to an S3
bucket.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/StartImportResponse'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'402':
description: ServiceQuotaExceededException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceQuotaExceededException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/StartImportRequest'
tags:
- Imports
components:
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: lex
schemas:
AudioFillerSettings:
type: object
properties:
enabled:
type: boolean
description: Specifies whether audio filler playback is enabled for the bot locale. Set to true to play filler audio
while Amazon Lex processes a user utterance. Set to false to disable filler audio.
audioType:
type: string
enum:
- MELODY_CHIPPER_CHIME
- MELODY_CURIOUS_CRAWL
- MELODY_RISING_RIPPLE
- MELODY_PATIENT_PING
- MELODY_PONDERING_PONG
- TYPING_KINETIC_KEYS
- TYPING_QUIET_QWERTY
description: The identifier of the audio filler to play while Amazon Lex processes the user's input. This field
is required when enabled is true.
startDelayInMilliseconds:
type: integer
description: The time, in milliseconds, to wait after the end of the user's utterance before starting audio filler
playback. Valid range is 500 to 5000 milliseconds. If not specified, Amazon Lex uses a default of 2500 milliseconds.
minimumPlayDurationInMilliseconds:
type: integer
description: The minimum time, in milliseconds, that audio filler plays once it has started, even if the bot response
becomes ready sooner. Valid range is 1000 to 5000 milliseconds. If not specified, Amazon Lex uses a default of
3000 milliseconds.
responseDeliveryDelayInMilliseconds:
type: integer
description: The silent delay, in milliseconds, inserted between the end of audio filler playback and the start
of the bot's response. Valid range is 200 to 1000 milliseconds. If not specified, Amazon Lex uses a default of
500 milliseconds.
BotImportSpecification:
type: object
properties:
botName:
type: string
description: The name that Amazon Lex should use for the bot.
roleArn:
type: string
description: The Amazon Resource Name (ARN) of the IAM role used to build and run the bot.
dataPrivacy:
$ref: '#/components/schemas/DataPrivacy'
errorLogSettings:
$ref: '#/components/schemas/ErrorLogSettings'
idleSessionTTLInSeconds:
type: integer
description: The time, in seconds, that Amazon Lex should keep information about a user's conversation with the
bot. A user interaction remains active for the amount of time specified. If no conversation occurs during this
time, the session expires and Amazon Lex deletes any data provided before the timeout. You can specify between
60 (1 minute) and 86,400 (24 hours) seconds.
botTags:
type: object
additionalProperties:
type: string
description: A list of tags to add to the bot. You can only add tags when you import a bot. You can't use the UpdateBot
operation to update tags. To update tags, use the TagResource operation.
testBotAliasTags:
type: object
additionalProperties:
type: string
description: A list of tags to add to the test alias for a bot. You can only add tags when you import a bot. You
can't use the UpdateAlias operation to update tags. To update tags on the test alias, use the TagResource operation.
required:
- botName
- roleArn
- dataPrivacy
BotLocaleImportSpecification:
type: object
properties:
botId:
type: string
description: The identifier of the bot to import the locale to.
botVersion:
type: string
description: The version of the bot to import the locale to. This can only be the DRAFT version of the bot.
localeId:
type: string
description: The identifier of the language and locale that the bot will be used in. The string must match one of
the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For
more information, see Supported languages.
nluIntentConfidenceThreshold:
type: number
description: 'Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent,
or both when returning alternative intents. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted
if they are configured for the bot. For example, suppose a bot is configured with the confidence threshold of
0.80 and the AMAZON.FallbackIntent. Amazon Lex returns three alternative intents with the following confidence
scores: IntentA (0.70), IntentB (0.60), IntentC (0.50). The response from the PostText operation would be: AMAZON.FallbackIntent
IntentA IntentB IntentC'
voiceSettings:
$ref: '#/components/schemas/VoiceSettings'
speechRecognitionSettings:
$ref: '#/components/schemas/SpeechRecognitionSettings'
speechDetectionSensitivity:
type: string
enum:
- Default
- HighNoiseTolerance
- MaximumNoiseTolerance
description: The sensitivity level for voice activity detection (VAD) in the bot locale. This setting helps optimize
speech recognition accuracy by adjusting how the system responds to background noise during voice interactions.
unifiedSpeechSettings:
$ref: '#/components/schemas/UnifiedSpeechSettings'
audioFillerSettings:
$ref: '#/components/schemas/AudioFillerSettings'
speakerDiarizationSettings:
$ref: '#/components/schemas/SpeakerDiarizationSettings'
required:
- botId
- botVersion
- localeId
ConflictException:
type: object
properties:
message:
type: string
CustomVocabularyImportSpecification:
type: object
properties:
botId:
type: string
description: The identifier of the bot to import the custom vocabulary to.
botVersion:
type: string
description: The version of the bot to import the custom vocabulary to.
localeId:
type: string
description: The identifier of the local to import the custom vocabulary to. The value must be en_GB.
required:
- botId
- botVersion
- localeId
DataPrivacy:
type: object
properties:
childDirected:
type: boolean
description: For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether
your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in
whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA)
by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm
that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted,
in whole or in part, to children under age 13 and
required:
- childDirected
DeepgramSpeechModelConfig:
type: object
properties:
apiTokenSecretArn:
type: string
description: The Amazon Resource Name (ARN) of the Secrets Manager secret that contains the Deepgram API token.
modelId:
type: string
description: The identifier of the Deepgram speech-to-text model to use for processing speech input.
required:
- apiTokenSecretArn
DeleteImportRequest:
type: object
properties:
importId:
type: string
description: The unique identifier of the import to delete.
required:
- importId
DeleteImportResponse:
type: object
properties:
importId:
type: string
description: The unique identifier of the deleted import.
importStatus:
type: string
enum:
- InProgress
- Completed
- Failed
- Deleting
description: The current status of the deletion. When the deletion is complete, the import will no longer be returned
by the ListImports operation and calls to the DescribeImport operation with the import identifier will fail.
DescribeImportRequest:
type: object
properties:
importId:
type: string
description: The unique identifier of the import to describe.
required:
- importId
DescribeImportResponse:
type: object
properties:
importId:
type: string
description: The unique identifier of the described import.
resourceSpecification:
$ref: '#/components/schemas/ImportResourceSpecification'
importedResourceId:
type: string
description: The unique identifier that Amazon Lex assigned to the resource created by the import.
importedResourceName:
type: string
description: The name of the imported resource.
mergeStrategy:
type: string
enum:
- Overwrite
- FailOnConflict
- Append
description: The strategy used when there was a name conflict between the imported resource and an existing resource.
When the merge strategy is FailOnConflict existing resources are not overwritten and the import fails.
importStatus:
type: string
enum:
- InProgress
- Completed
- Failed
- Deleting
description: The status of the import process. When the status is Completed the resource is imported and ready for
use.
failureReasons:
type: array
items:
type: string
description: If the importStatus field is Failed, this provides one or more reasons for the failure.
creationDateTime:
type: string
format: date-time
description: The date and time that the import was created.
lastUpdatedDateTime:
type: string
format: date-time
description: The date and time that the import was last updated.
ErrorLogSettings:
type: object
properties:
enabled:
type: boolean
description: Settings parameters for the error logs, when it is enabled.
required:
- enabled
ImportFilter:
type: object
properties:
name:
type: string
enum:
- ImportResourceType
description: The name of the field to use for filtering.
values:
type: array
items:
type: string
description: The values to use to filter the response. The values must be Bot, BotLocale, or CustomVocabulary.
operator:
type: string
enum:
- CO
- EQ
description: The operator to use for the filter. Specify EQ when the ListImports operation should return only resource
types that equal the specified value. Specify CO when the ListImports operation should return resource types that
contain the specified value.
required:
- name
- values
- operator
ImportResourceSpecification:
type: object
properties:
botImportSpecification:
$ref: '#/components/schemas/BotImportSpecification'
botLocaleImportSpecification:
$ref: '#/components/schemas/BotLocaleImportSpecification'
customVocabularyImportSpecification:
$ref: '#/components/schemas/CustomVocabularyImportSpecification'
testSetImportResourceSpecification:
$ref: '#/components/schemas/TestSetImportResourceSpecification'
ImportSortBy:
type: object
properties:
attribute:
type: string
enum:
- LastUpdatedDateTime
description: The export field to use for sorting.
order:
type: string
enum:
- Ascending
- Descending
description: The order to sort the list.
required:
- attribute
- order
ImportSummary:
type: object
properties:
importId:
type: string
description: The unique identifier that Amazon Lex assigned to the import.
importedResourceId:
type: string
description: The unique identifier that Amazon Lex assigned to the imported resource.
importedResourceName:
type: string
description: The name that you gave the imported resource.
importStatus:
type: string
enum:
- InProgress
- Completed
- Failed
- Deleting
description: The status of the resource. When the status is Completed the resource is ready to build.
mergeStrategy:
type: string
enum:
- Overwrite
- FailOnConflict
- Append
description: The strategy used to merge existing bot or bot locale definitions with the imported definition.
creationDateTime:
type: string
format: date-time
description: The date and time that the import was created.
lastUpdatedDateTime:
type: string
format: date-time
description: The date and time that the import was last updated.
importedResourceType:
type: string
enum:
- Bot
- BotLocale
- CustomVocabulary
- TestSet
description: The type of resource that was imported.
InternalServerException:
type: object
properties:
message:
type: string
ListImportsRequest:
type: object
properties:
botId:
type: string
description: The unique identifier that Amazon Lex assigned to the bot.
botVersion:
type: string
description: The version of the bot to list imports for.
sortBy:
$ref: '#/components/schemas/ImportSortBy'
filters:
type: array
items:
$ref: '#/components/schemas/ImportFilter'
description: 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.
maxResults:
type: integer
description: 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:
type: string
description: If the response from the ListImports operation contains more results than specified in the maxResults
parameter, a token is returned in the response. Use the returned token in the nextToken parameter of a ListImports
request to return the next page of results. For a complete set of results, call the ListImports operation until
the nextToken returned in the response is null.
localeId:
type: string
description: Specifies the locale that should be present in the list. If you don't specify a resource type in the
filters parameter, the list contains both bot locales and custom vocabularies.
ListImportsResponse:
type: object
properties:
botId:
type: string
description: The unique identifier assigned by Amazon Lex to the bot.
botVersion:
type: string
description: The version of the bot that was imported. It will always be DRAFT.
importSummaries:
type: array
items:
$ref: '#/components/schemas/ImportSummary'
description: Summary information for the imports that meet the filter criteria specified in the request. The length
of the list is specified in the maxResults parameter. If there are more imports available, the nextToken field
contains a token to get the next page of results.
nextToken:
type: string
description: A token that indicates whether there are more results to return in a response to the ListImports operation.
If the nextToken field is present, you send the contents as the nextToken parameter of a ListImports operation
request to get the next page of results.
localeId:
type: string
description: The locale specified in the request.
PreconditionFailedException:
type: object
properties:
message:
type: string
ResourceNotFoundException:
type: object
properties:
message:
type: string
ServiceQuotaExceededException:
type: object
properties:
message:
type: string
SpeakerDiarizationSettings:
type: object
properties:
enabled:
type: boolean
description: Specifies whether speaker diarization is enabled for the bot locale. Set to true to have Amazon Lex
treat speech from speakers other than the primary speaker as non-speech. Set to false to disable speaker diarization
and rely on voice activity detection alone.
required:
- enabled
SpeechFoundationModel:
type: object
properties:
modelArn:
type: string
description: The Amazon Resource Name (ARN) of the foundation model used for speech processing.
voiceId:
type: string
description: The identifier of the voice to use for speech synthesis with the foundation model.
required:
- modelArn
SpeechModelConfig:
type: object
properties:
deepgramConfig:
$ref: '#/components/schemas/DeepgramSpeechModelConfig'
SpeechRecognitionSettings:
type: object
properties:
speechModelPreference:
type: string
enum:
- Standard
- Neural
- Deepgram
- Advanced
description: The speech-to-text model to use.
speechModelConfig:
$ref: '#/components/schemas/SpeechModelConfig'
StartImportRequest:
type: object
properties:
importId:
type: string
description: The unique identifier for the import. It is included in the response from the CreateUploadUrl operation.
resourceSpecification:
$ref: '#/components/schemas/ImportResourceSpecification'
mergeStrategy:
type: string
enum:
- Overwrite
- FailOnConflict
- Append
description: The strategy to use when there is a name conflict between the imported resource and an existing resource.
When the merge strategy is FailOnConflict existing resources are not overwritten and the import fails.
filePassword:
type: string
description: The password used to encrypt the zip archive that contains the resource definition. You should always
encrypt the zip archive to protect it during transit between your site and Amazon Lex.
required:
- importId
- resourceSpecification
- mergeStrategy
StartImportResponse:
type: object
properties:
importId:
type: string
description: A unique identifier for the import.
resourceSpecification:
$ref: '#/components/schemas/ImportResourceSpecification'
mergeStrategy:
type: string
enum:
- Overwrite
- FailOnConflict
- Append
description: The strategy used when there was a name conflict between the imported resource and an existing resource.
When the merge strategy is FailOnConflict existing resources are not overwritten and the import fails.
importStatus:
type: string
enum:
- InProgress
- Completed
- Failed
- Deleting
description: The current status of the import. When the status is Complete the bot, bot alias, or custom vocabulary
is ready to use.
creationDateTime:
type: string
format: date-time
description: The date and time that the import request was created.
TestSetImportInputLocation:
type: object
properties:
s3BucketName:
type: string
description: The name of the Amazon S3 bucket.
s3Path:
type: string
description: The path inside the Amazon S3 bucket pointing to the test-set CSV file.
required:
- s3BucketName
- s3Path
TestSetImportResourceSpecification:
type: object
properties:
testSetName:
type: string
description: The name of the test set.
description:
type: string
description: The description of the test set.
roleArn:
type: string
description: The Amazon Resource Name (ARN) of an IAM role that has permission to access the test set.
storageLocation:
$ref: '#/components/schemas/TestSetStorageLocation'
importInputLocation:
$ref: '#/components/schemas/TestSetImportInputLocation'
modality:
type: string
enum:
- Text
- Audio
description: Specifies whether the test-set being imported contains written or spoken data.
testSetTags:
type: object
additionalProperties:
type: string
description: A list of tags to add to the test set. You can only add tags when you import/generate a new test set.
You can't use the UpdateTestSet operation to update tags. To update tags, use the TagResource operation.
required:
- testSetName
- roleArn
- storageLocation
- importInputLocation
- modality
TestSetStorageLocation:
type: object
properties:
s3BucketName:
type: string
description: The name of the Amazon S3 bucket in which the test set is stored.
s3Path:
type: string
description: The path inside the Amazon S3 bucket where the test set is stored.
kmsKeyArn:
type: string
description: The Amazon Resource Name (ARN) of an Amazon Web Services Key Management Service (KMS) key for encrypting
the test set.
required:
- s3BucketName
- s3Path
ThrottlingException:
type: object
properties:
retryAfterSeconds:
type: integer
description: The number of seconds after which the user can invoke the API again.
message:
type: string
UnifiedSpeechSettings:
type: object
properties:
speechFoundationModel:
$ref: '#/components/schemas/SpeechFoundationModel'
required:
- speechFoundationModel
ValidationException:
type: object
properties:
message:
type: string
VoiceSettings:
type: object
properties:
engine:
type: string
enum:
- standard
- neural
- long-form
- generative
description: Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the
user. For more information, see the engine parameter of the SynthesizeSpeech operation in the Amazon Polly developer
guide. If you do not specify a value, the default is standard.
voiceId:
type: string
description: The identifier of the Amazon Polly voice to use.
required:
- voiceId
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/lex-models-v2/service/2020-08-07/lex-models-v2-2020-08-07.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)