API Evangelist conversational phrasing for Amazon Lex Bots API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon Lex Bots API
  version: 1.0.0
extends: openapi/amazon-lex-bots-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 80
- target: $.paths['/bots'].get
  update:
    x-apievangelist-phrasing:
      intent: List my conversational bots
      effect: read
      questions:
      - Which Lex bots do I have in this account?
      - Can I see every conversational bot I've built in Amazon Lex?
      instructions:
      - text: List all of my Lex bots.
      - text: Show me every conversational bot available in this account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a bot with name, role and privacy settings
      effect: write
      questions:
      - How do I create a new Lex bot with an IAM role and an idle session timeout?
      - What do I have to set for data privacy when I create a bot?
      - Can a new bot be created as a network of member bots?
      instructions:
      - text: Create a bot named {botName} using IAM role {roleArn} with a {idleSessionTTLInSeconds}-second idle session timeout and privacy setting {dataPrivacy}.
        slots:
          botName: requestBody.botName
          roleArn: requestBody.roleArn
          idleSessionTTLInSeconds: requestBody.idleSessionTTLInSeconds
          dataPrivacy: requestBody.dataPrivacy
      - text: Create a bot network called {botName} with member bots {botMembers}, using role {roleArn}, privacy {dataPrivacy} and a {idleSessionTTLInSeconds}s timeout.
        slots:
          botName: requestBody.botName
          botMembers: requestBody.botMembers
          roleArn: requestBody.roleArn
          dataPrivacy: requestBody.dataPrivacy
          idleSessionTTLInSeconds: requestBody.idleSessionTTLInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a bot via the POST /bots endpoint
      effect: write
      questions:
      - Is there a POST /bots variant for creating a Lex bot with no request fields?
      - What does the bare POST create-bot call on /bots do?
      instructions:
      - text: Call the POST /bots create-bot endpoint to make a new bot.
      - text: Use the parameterless POST variant of create bot.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a bot's details
      effect: read
      questions:
      - What's the configuration and status of one of my bots?
      - Can I look up the role and idle timeout set on a particular bot?
      instructions:
      - text: Describe bot {botId}.
        slots:
          botId: path.botId
      - text: Show me the metadata for bot {botId}.
        slots:
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a bot's configuration
      effect: write
      questions:
      - How do I change the configuration of a bot that already exists?
      - Can I edit an existing bot's settings after creating it?
      instructions:
      - text: Update the configuration of bot {botId}.
        slots:
          botId: path.botId
      - text: Apply new settings to my existing bot {botId}.
        slots:
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a bot and all its versions
      effect: destructive
      questions:
      - How do I delete a Lex bot entirely, including its Draft version?
      - Does deleting a bot remove every version of it?
      instructions:
      - text: Delete bot {botId} and all of its versions.
        slots:
          botId: path.botId
      - text: Permanently remove the whole bot {botId}, Draft included.
        slots:
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents'].get
  update:
    x-apievangelist-phrasing:
      intent: List intents in a bot locale
      effect: read
      questions:
      - Which intents are defined in my bot for a given language?
      - Can I get all the intents in one locale of a bot version?
      instructions:
      - text: List the intents in bot {botId} version {botVersion} for locale {localeId}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show every intent in the {localeId} locale of bot {botId}, version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an intent with utterances and hooks
      effect: write
      questions:
      - How do I add a new intent like OrderPizza with sample utterances to my bot?
      - Can I base a new intent on a built-in intent signature?
      - Can a new intent call a Lambda code hook for fulfillment?
      instructions:
      - text: Create intent {intentName} in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          intentName: requestBody.intentName
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Add intent {intentName} with sample utterances {sampleUtterances} to the {localeId} locale of bot {botId} version {botVersion}.
        slots:
          intentName: requestBody.intentName
          sampleUtterances: requestBody.sampleUtterances
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: Create intent {intentName} extending built-in {parentIntentSignature} in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          intentName: requestBody.intentName
          parentIntentSignature: requestBody.parentIntentSignature
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an intent via the POST endpoint
      effect: write
      questions:
      - Is there a POST variant of create intent that takes no intent fields in the body?
      - What does the bare POST create-intent call on a bot locale do?
      instructions:
      - text: Use the POST create-intent endpoint on bot {botId} version {botVersion}, locale {localeId}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Call the parameterless POST intent-creation variant for locale {localeId} of bot {botId} version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/aggregatedutterances'].post
  update:
    x-apievangelist-phrasing:
      intent: See what users actually said to a bot
      effect: read
      questions:
      - What phrases are customers typing or saying to my bot, grouped by text?
      - Can I see how often users said the same utterance over the last day or week?
      - Which user utterances were missed by my bot's intents?
      instructions:
      - text: List aggregated user utterances for bot {botId} in locale {localeId} over {aggregationDuration}.
        slots:
          botId: path.botId
          localeId: requestBody.localeId
          aggregationDuration: requestBody.aggregationDuration
      - text: Show what users said to alias {botAliasId} of bot {botId} in {localeId} during {aggregationDuration}.
        slots:
          botAliasId: requestBody.botAliasId
          botId: path.botId
          localeId: requestBody.localeId
          aggregationDuration: requestBody.aggregationDuration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/analytics/intentmetrics'].post
  update:
    x-apievangelist-phrasing:
      intent: Get summary metrics for a bot's intents
      effect: read
      questions:
      - How many times was each intent in my bot matched or failed last month?
      - Can I get intent success and failure counts binned by day?
      instructions:
      - text: Get intent metrics {metrics} for bot {botId} from {startDateTime} to {endDateTime}.
        slots:
          metrics: requestBody.metrics
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      - text: Report intent metrics {metrics} for bot {botId} between {startDateTime} and {endDateTime}, grouped by {groupBy}.
        slots:
          metrics: requestBody.metrics
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
          groupBy: requestBody.groupBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/analytics/intentpaths'].post
  update:
    x-apievangelist-phrasing:
      intent: Analyze the paths of intents users take
      effect: read
      questions:
      - What sequence of intents do users go through in sessions with my bot?
      - Which intents do people hit after a given intent path in a conversation?
      instructions:
      - text: Show intent path statistics for {intentPath} on bot {botId} from {startDateTime} to {endDateTime}.
        slots:
          intentPath: requestBody.intentPath
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      - text: Trace where sessions go after intent path {intentPath} in bot {botId}, {startDateTime} through {endDateTime}.
        slots:
          intentPath: requestBody.intentPath
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/analytics/intentstagemetrics'].post
  update:
    x-apievangelist-phrasing:
      intent: Get metrics for stages within intents
      effect: read
      questions:
      - Where inside an intent do conversations stall, stage by stage?
      - Can I see metrics for each stage of my bot's intents, like slot elicitation?
      instructions:
      - text: Pull per-stage metrics {metrics} inside the intents of bot {botId}, {startDateTime} through {endDateTime}.
        slots:
          metrics: requestBody.metrics
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      - text: Break down stage-level metrics {metrics} for bot {botId} between {startDateTime} and {endDateTime} by {binBy}.
        slots:
          metrics: requestBody.metrics
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
          binBy: requestBody.binBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/analytics/sessionmetrics'].post
  update:
    x-apievangelist-phrasing:
      intent: Get summary metrics for bot user sessions
      effect: read
      questions:
      - How many user sessions did my bot have, and how long did they last?
      - Can I get session count and duration metrics summarized over a date range?
      instructions:
      - text: Get session metrics {metrics} for bot {botId} from {startDateTime} to {endDateTime}.
        slots:
          metrics: requestBody.metrics
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      - text: Summarize session totals for bot {botId} between {startDateTime} and {endDateTime}.
        slots:
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/analytics/sessions'].post
  update:
    x-apievangelist-phrasing:
      intent: List metadata for individual bot sessions
      effect: read
      questions:
      - Can I pull a list of individual conversations users had with my bot?
      - Which specific sessions happened on my bot during a given time window?
      instructions:
      - text: List individual session records for bot {botId} from {startDateTime} to {endDateTime}.
        slots:
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      - text: Show each user session on bot {botId} between {startDateTime} and {endDateTime}, sorted by {sortBy}.
        slots:
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
          sortBy: requestBody.sortBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/analytics/utterancemetrics'].post
  update:
    x-apievangelist-phrasing:
      intent: Get summary metrics for bot utterances
      effect: read
      questions:
      - How many utterances did my bot detect versus miss over a period?
      - What IAM permission do I need to read utterance metrics for my bot?
      instructions:
      - text: Get utterance metrics {metrics} for bot {botId} from {startDateTime} to {endDateTime}.
        slots:
          metrics: requestBody.metrics
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      - text: Summarize utterance counts for bot {botId} between {startDateTime} and {endDateTime} with attributes {attributes}.
        slots:
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
          attributes: requestBody.attributes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/analytics/utterances'].post
  update:
    x-apievangelist-phrasing:
      intent: List individual utterance records for a bot
      effect: read
      questions:
      - Can I get the individual utterances users sent my bot, one record each?
      - Where do I find per-utterance analytics data for a date range?
      instructions:
      - text: List individual utterance records for bot {botId} from {startDateTime} to {endDateTime}.
        slots:
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
      - text: Pull each utterance record from bot {botId} between {startDateTime} and {endDateTime}, filtered by {filters}.
        slots:
          botId: path.botId
          startDateTime: requestBody.startDateTime
          endDateTime: requestBody.endDateTime
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botaliases'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an alias pointing to a bot version
      effect: write
      questions:
      - How do I create a production alias so apps don't need to change when I ship a new bot version?
      - Can a new alias turn on conversation logs and sentiment analysis?
      instructions:
      - text: Create alias {botAliasName} on bot {botId} pointing to version {botVersion}.
        slots:
          botAliasName: requestBody.botAliasName
          botId: path.botId
          botVersion: requestBody.botVersion
      - text: Add a new alias named {botAliasName} to bot {botId}.
        slots:
          botAliasName: requestBody.botAliasName
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botaliases'].post
  update:
    x-apievangelist-phrasing:
      intent: List a bot's aliases
      effect: read
      questions:
      - What aliases exist for my bot?
      - Which aliases have I set up on a particular bot?
      instructions:
      - text: List the aliases for bot {botId}.
        slots:
          botId: path.botId
      - text: Show up to {maxResults} aliases of bot {botId}.
        slots:
          maxResults: requestBody.maxResults
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botaliases/{botAliasId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a bot alias
      effect: read
      questions:
      - Which bot version is a specific alias currently pointing to?
      - Can I check the log and sentiment settings on one alias?
      instructions:
      - text: Describe alias {botAliasId} of bot {botId}.
        slots:
          botAliasId: path.botAliasId
          botId: path.botId
      - text: Show the configuration of bot alias {botAliasId} on bot {botId}.
        slots:
          botAliasId: path.botAliasId
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botaliases/{botAliasId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Repoint or reconfigure a bot alias
      effect: write
      questions:
      - How do I switch an existing alias to a newer bot version?
      - Can I change conversation log settings on an alias I already have?
      instructions:
      - text: Point alias {botAliasId} ({botAliasName}) of bot {botId} at version {botVersion}.
        slots:
          botAliasId: path.botAliasId
          botAliasName: requestBody.botAliasName
          botId: path.botId
          botVersion: requestBody.botVersion
      - text: Rename alias {botAliasId} on bot {botId} to {botAliasName}.
        slots:
          botAliasId: path.botAliasId
          botId: path.botId
          botAliasName: requestBody.botAliasName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botaliases/{botAliasId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a bot alias
      effect: destructive
      questions:
      - How do I remove an alias from my bot?
      - Can I delete an alias even if it's still in use by something?
      instructions:
      - text: Delete alias {botAliasId} from bot {botId}.
        slots:
          botAliasId: path.botAliasId
          botId: path.botId
      - text: Delete alias {botAliasId} of bot {botId}, skipping the in-use check ({skipResourceInUseCheck}).
        slots:
          botAliasId: path.botAliasId
          botId: path.botId
          skipResourceInUseCheck: query.skipResourceInUseCheck
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botanalyzer'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an AI analysis of a bot's configuration
      effect: write
      questions:
      - Can Lex analyze my bot's design and recommend improvements based on best practices?
      - How do I kick off an automated review of my bot to find configuration issues?
      instructions:
      - text: Start a bot analyzer run on bot {botId} with scope {analysisScope}.
        slots:
          botId: path.botId
          analysisScope: requestBody.analysisScope
      - text: Analyze bot {botId} version {botVersion} in locale {localeId} with scope {analysisScope} for improvement recommendations.
        slots:
          botId: path.botId
          botVersion: requestBody.botVersion
          localeId: requestBody.localeId
          analysisScope: requestBody.analysisScope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botanalyzer/describe/{botAnalyzerRequestId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a bot analysis's recommendations
      effect: read
      questions:
      - What did the bot analyzer recommend I fix once the analysis finished?
      - Can I page through the recommendations from a completed bot analysis?
      instructions:
      - text: Show the recommendations from bot analysis {botAnalyzerRequestId} on bot {botId}.
        slots:
          botAnalyzerRequestId: path.botAnalyzerRequestId
          botId: path.botId
      - text: Get the analyzer results for request {botAnalyzerRequestId} of bot {botId}.
        slots:
          botAnalyzerRequestId: path.botAnalyzerRequestId
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botanalyzer/history'].post
  update:
    x-apievangelist-phrasing:
      intent: List past bot analysis runs
      effect: read
      questions:
      - Which analyzer runs have been executed against my bot before?
      - Can I filter a bot's analysis history by locale and version?
      instructions:
      - text: List the analysis history for bot {botId}.
        slots:
          botId: path.botId
      - text: Show past analyzer runs on bot {botId} for version {botVersion} in locale {localeId}.
        slots:
          botId: path.botId
          botVersion: requestBody.botVersion
          localeId: requestBody.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botanalyzer/{botAnalyzerRequestId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete a bot analysis's results
      effect: destructive
      questions:
      - How do I permanently erase analyzer recommendations for GDPR purposes?
      - Can deleted bot analysis results be recovered afterwards?
      instructions:
      - text: Delete the analysis results for request {botAnalyzerRequestId} on bot {botId}.
        slots:
          botAnalyzerRequestId: path.botAnalyzerRequestId
          botId: path.botId
      - text: Permanently erase the analyzer recommendations {botAnalyzerRequestId} from bot {botId}.
        slots:
          botAnalyzerRequestId: path.botAnalyzerRequestId
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botanalyzer/{botAnalyzerRequestId}/stop'].put
  update:
    x-apievangelist-phrasing:
      intent: Cancel a running bot analysis
      effect: destructive
      questions:
      - How do I stop a bot analysis that's still in progress?
      - Can a cancelled bot analysis be resumed later?
      instructions:
      - text: Stop bot analysis {botAnalyzerRequestId} on bot {botId}.
        slots:
          botAnalyzerRequestId: path.botAnalyzerRequestId
          botId: path.botId
      - text: Cancel the running analyzer job {botAnalyzerRequestId} for bot {botId}.
        slots:
          botAnalyzerRequestId: path.botAnalyzerRequestId
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish an immutable bot version
      effect: write
      questions:
      - How do I snapshot my Draft bot into a numbered, immutable version?
      - Are deleted bot version numbers ever reused?
      instructions:
      - text: Create a new version of bot {botId} from locales {botVersionLocaleSpecification}.
        slots:
          botId: path.botId
          botVersionLocaleSpecification: requestBody.botVersionLocaleSpecification
      - text: Publish a numbered version of bot {botId} described as {description} using {botVersionLocaleSpecification}.
        slots:
          botId: path.botId
          description: requestBody.description
          botVersionLocaleSpecification: requestBody.botVersionLocaleSpecification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions'].post
  update:
    x-apievangelist-phrasing:
      intent: List a bot's versions
      effect: read
      questions:
      - What numbered versions of my bot exist?
      - Can I sort the list of a bot's versions?
      instructions:
      - text: List all versions of bot {botId}.
        slots:
          botId: path.botId
      - text: Show the versions of bot {botId} sorted by {sortBy}.
        slots:
          botId: path.botId
          sortBy: requestBody.sortBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one bot version
      effect: read
      questions:
      - What's the status and metadata of a specific version of my bot?
      - Can I inspect one numbered bot version on its own?
      instructions:
      - text: Describe version {botVersion} of bot {botId}.
        slots:
          botVersion: path.botVersion
          botId: path.botId
      - text: Show metadata for bot {botId} at version {botVersion}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one version of a bot
      effect: destructive
      questions:
      - How do I delete just one old version of a bot without removing the bot?
      - Can I force-delete a bot version that an alias still uses?
      instructions:
      - text: Delete version {botVersion} of bot {botId}.
        slots:
          botVersion: path.botVersion
          botId: path.botId
      - text: Remove bot {botId} version {botVersion} with skipResourceInUseCheck set to {skipResourceInUseCheck}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          skipResourceInUseCheck: query.skipResourceInUseCheck
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a language locale to a bot
      effect: write
      questions:
      - How do I add Spanish or another language to my bot?
      - What confidence threshold must I set when adding a locale?
      - Can I choose a voice when I add a new locale to a bot?
      instructions:
      - text: Add locale {localeId} to bot {botId} version {botVersion} with an intent confidence threshold of {nluIntentConfidenceThreshold}.
        slots:
          localeId: requestBody.localeId
          botId: path.botId
          botVersion: path.botVersion
          nluIntentConfidenceThreshold: requestBody.nluIntentConfidenceThreshold
      - text: Create locale {localeId} on bot {botId} version {botVersion} with threshold {nluIntentConfidenceThreshold} and voice {voiceSettings}.
        slots:
          localeId: requestBody.localeId
          botId: path.botId
          botVersion: path.botVersion
          nluIntentConfidenceThreshold: requestBody.nluIntentConfidenceThreshold
          voiceSettings: requestBody.voiceSettings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales'].post
  update:
    x-apievangelist-phrasing:
      intent: List the locales in a bot version
      effect: read
      questions:
      - Which languages does my bot support?
      - Can I list the locales configured on a given bot version?
      instructions:
      - text: List the locales in bot {botId} version {botVersion}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
      - text: Show which languages bot {botId} version {botVersion} has, filtered by {filters}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a bot locale's settings
      effect: read
      questions:
      - What confidence threshold and voice are configured for one of my bot's locales?
      - Has a particular bot locale been built yet?
      instructions:
      - text: Describe locale {localeId} of bot {botId} version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: Show the build status and settings for {localeId} on bot {botId}, version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a bot locale's settings
      effect: write
      questions:
      - How do I raise the intent confidence threshold on an existing locale?
      - Can I change the voice or speech detection sensitivity for a locale I already added?
      instructions:
      - text: Set the confidence threshold for locale {localeId} of bot {botId} version {botVersion} to {nluIntentConfidenceThreshold}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
          nluIntentConfidenceThreshold: requestBody.nluIntentConfidenceThreshold
      - text: 'Update locale {localeId} on bot {botId} version {botVersion}: threshold {nluIntentConfidenceThreshold}, speech sensitivity {speechDetectionSensitivity}.'
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
          nluIntentConfidenceThreshold: requestBody.nluIntentConfidenceThreshold
          speechDetectionSensitivity: requestBody.speechDetectionSensitivity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a bot for a locale
      effect: write
      questions:
      - How do I build my bot's intents and slot types so a locale is ready to test?
      - Do I need to rebuild a locale after changing its intents?
      instructions:
      - text: Build locale {localeId} of bot {botId} version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: Compile bot {botId} version {botVersion} into the {localeId} locale.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a locale from a bot
      effect: destructive
      questions:
      - How do I remove a language from my bot?
      - Does deleting a locale also delete its intents and slot types?
      instructions:
      - text: Delete locale {localeId} from bot {botId} version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: Remove the {localeId} language and everything in it from bot {botId}, version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amazon-lex/refs/heads/main/overlays/amazon-lex-bots-api-phrasing-overlay.yaml