# 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'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/botrecommendations'].put
  update:
    x-apievangelist-phrasing:
      intent: Start intent recommendations from transcripts
      effect: write
      questions:
      - Can Lex suggest intents for my bot from existing call or chat transcripts?
      - How do I feed conversation transcripts in to get bot design recommendations?
      instructions:
      - text: Start a bot recommendation for bot {botId} version {botVersion}, locale {localeId}, using transcripts from {transcriptSourceSetting}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          transcriptSourceSetting: requestBody.transcriptSourceSetting
      - text: Analyze transcripts at {transcriptSourceSetting} for locale {localeId} of bot {botId} version {botVersion}, encrypted with {encryptionSetting}.
        slots:
          transcriptSourceSetting: requestBody.transcriptSourceSetting
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
          encryptionSetting: requestBody.encryptionSetting
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/botrecommendations'].post
  update:
    x-apievangelist-phrasing:
      intent: List transcript-based bot recommendations
      effect: read
      questions:
      - Which bot recommendation requests have I run for a locale?
      - Can I see all transcript analysis jobs for my bot's locale?
      instructions:
      - text: List bot recommendations for bot {botId} version {botVersion}, locale {localeId}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show the transcript recommendation jobs on 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}/botrecommendations/{botRecommendationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get status of a bot recommendation job
      effect: read
      questions:
      - Is my transcript-based bot recommendation finished processing?
      - Where can I download the transcripts associated with a recommendation?
      instructions:
      - text: Describe bot recommendation {botRecommendationId} for bot {botId} version {botVersion}, locale {localeId}.
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Check the status of recommendation job {botRecommendationId} on bot {botId} ({botVersion}, {localeId}).
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/botrecommendations/{botRecommendationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change encryption on a bot recommendation
      effect: write
      questions:
      - Can I change the encryption settings of a bot recommendation request I already started?
      - How do I update the KMS encryption on an existing recommendation job?
      instructions:
      - text: Update the encryption of recommendation {botRecommendationId} on bot {botId} version {botVersion}, locale {localeId}, to {encryptionSetting}.
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          encryptionSetting: requestBody.encryptionSetting
      - text: Set encryption {encryptionSetting} on existing bot recommendation {botRecommendationId} for bot {botId} ({botVersion}, {localeId}).
        slots:
          encryptionSetting: requestBody.encryptionSetting
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/botrecommendations/{botRecommendationId}/associatedtranscripts'].post
  update:
    x-apievangelist-phrasing:
      intent: Search transcripts tied to a bot recommendation
      effect: read
      questions:
      - Can I search the transcripts that were used for a bot recommendation?
      - Which transcripts associated with a recommendation match my filter?
      instructions:
      - text: Search transcripts for recommendation {botRecommendationId} on bot {botId} version {botVersion}, locale {localeId}, with filters {filters}.
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          filters: requestBody.filters
      - text: Find associated transcripts matching {filters} in recommendation {botRecommendationId} of bot {botId} ({botVersion}, {localeId}), ordered {searchOrder}.
        slots:
          filters: requestBody.filters
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          searchOrder: requestBody.searchOrder
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/botrecommendations/{botRecommendationId}/intents'].post
  update:
    x-apievangelist-phrasing:
      intent: List intents recommended from transcripts
      effect: read
      questions:
      - What intents did the transcript analysis suggest I add to my bot?
      - Are recommended intents ranked by relevance?
      instructions:
      - text: List recommended intents from recommendation {botRecommendationId} for bot {botId} version {botVersion}, locale {localeId}.
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show the suggested intents produced by job {botRecommendationId} on bot {botId} ({botVersion}, {localeId}).
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/botrecommendations/{botRecommendationId}/stopbotrecommendation'].put
  update:
    x-apievangelist-phrasing:
      intent: Stop a running bot recommendation job
      effect: destructive
      questions:
      - How do I halt a transcript recommendation job that's still running?
      - Can I cancel an in-progress bot recommendation request?
      instructions:
      - text: Stop bot recommendation {botRecommendationId} on bot {botId} version {botVersion}, locale {localeId}.
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Cancel the running recommendation job {botRecommendationId} for bot {botId} ({botVersion}, {localeId}).
        slots:
          botRecommendationId: path.botRecommendationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a locale's custom vocabulary
      effect: destructive
      questions:
      - How do I delete the entire custom vocabulary from a bot locale?
      - Can I drop all custom vocabulary for one language of my bot at once?
      instructions:
      - text: Delete the custom vocabulary from locale {localeId} of bot {botId} version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: Remove the whole custom vocabulary on bot {botId} ({botVersion}) for {localeId}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/batchcreate'].put
  update:
    x-apievangelist-phrasing:
      intent: Add custom vocabulary items in bulk
      effect: write
      questions:
      - How do I teach my bot product names and jargon it keeps mishearing?
      - Can I add many custom vocabulary phrases to a locale in one call?
      instructions:
      - text: Add vocabulary items {customVocabularyItemList} to locale {localeId} of bot {botId} version {botVersion}.
        slots:
          customVocabularyItemList: requestBody.customVocabularyItemList
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: 'Create these custom vocabulary entries for bot {botId} ({botVersion}, {localeId}): {customVocabularyItemList}.'
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          customVocabularyItemList: requestBody.customVocabularyItemList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/batchdelete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete custom vocabulary items in bulk
      effect: destructive
      questions:
      - Can I remove several specific words from my bot's custom vocabulary at once?
      - How do I delete selected custom vocabulary items without dropping the whole vocabulary?
      instructions:
      - text: Delete vocabulary items {customVocabularyItemList} from locale {localeId} of bot {botId} version {botVersion}.
        slots:
          customVocabularyItemList: requestBody.customVocabularyItemList
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: 'Remove these custom vocabulary entries from bot {botId} ({botVersion}, {localeId}): {customVocabularyItemList}.'
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          customVocabularyItemList: requestBody.customVocabularyItemList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/batchupdate'].put
  update:
    x-apievangelist-phrasing:
      intent: Update custom vocabulary items in bulk
      effect: write
      questions:
      - How do I change the weight or display form of existing custom vocabulary items?
      - Can I edit several vocabulary entries already in a locale in one request?
      instructions:
      - text: Update vocabulary items {customVocabularyItemList} in locale {localeId} of bot {botId} version {botVersion}.
        slots:
          customVocabularyItemList: requestBody.customVocabularyItemList
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: 'Modify these existing custom vocabulary entries on bot {botId} ({botVersion}, {localeId}): {customVocabularyItemList}.'
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          customVocabularyItemList: requestBody.customVocabularyItemList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List a locale's custom vocabulary items
      effect: read
      questions:
      - What words are in my bot locale's custom vocabulary right now?
      - Can I page through all the custom vocabulary items for a language?
      instructions:
      - text: List custom vocabulary items for locale {localeId} of bot {botId} version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: Show the first {maxResults} vocabulary entries on bot {botId} ({botVersion}, {localeId}).
        slots:
          maxResults: requestBody.maxResults
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary/DEFAULT/metadata'].get
  update:
    x-apievangelist-phrasing:
      intent: Get custom vocabulary metadata
      effect: read
      questions:
      - What's the status of the custom vocabulary on my bot locale?
      - When was a locale's custom vocabulary created or last updated?
      instructions:
      - text: Describe the custom vocabulary metadata for locale {localeId} of bot {botId} version {botVersion}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
      - text: Show the vocabulary status for bot {botId} ({botVersion}) in {localeId}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate sample utterances for an intent
      effect: write
      questions:
      - Can Lex write sample utterances for one of my intents automatically?
      - How do I get generated example phrases for an intent I already created?
      instructions:
      - text: Generate sample utterances for intent {intentId} in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          intentId: requestBody.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Suggest example phrases for intent {intentId} on bot {botId} ({botVersion}, {localeId}).
        slots:
          intentId: requestBody.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/generations'].post
  update:
    x-apievangelist-phrasing:
      intent: List descriptive bot builder generation requests
      effect: read
      questions:
      - Which generate-from-description requests have been made for my bot locale?
      - Can I sort the descriptive bot builder generation history?
      instructions:
      - text: List generation requests for bot {botId} version {botVersion}, locale {localeId}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show the descriptive bot builder runs on {localeId} of bot {botId} ({botVersion}) sorted by {sortBy}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
          sortBy: requestBody.sortBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/generations/{generationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a descriptive bot builder generation result
      effect: read
      questions:
      - Is the bot my natural-language description generated ready yet?
      - Where do I get the S3 link to the generated bot locale configuration?
      instructions:
      - text: Describe generation {generationId} for bot {botId} version {botVersion}, locale {localeId}.
        slots:
          generationId: path.generationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Get the status and output location of bot generation {generationId} on bot {botId} ({botVersion}, {localeId}).
        slots:
          generationId: path.generationId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an intent's details
      effect: read
      questions:
      - What sample utterances and hooks does a particular intent have?
      - Can I look at one intent's full configuration?
      instructions:
      - text: Describe intent {intentId} in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show the settings of intent {intentId} on bot {botId} ({botVersion}, {localeId}).
        slots:
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing intent
      effect: write
      questions:
      - How do I add more sample utterances to an intent I already built?
      - Can I change the order slots are prompted in for an existing intent?
      instructions:
      - text: Update intent {intentId} ({intentName}) in bot {botId} version {botVersion}, locale {localeId}, with utterances {sampleUtterances}.
        slots:
          intentId: path.intentId
          intentName: requestBody.intentName
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          sampleUtterances: requestBody.sampleUtterances
      - text: Set slot priorities {slotPriorities} on existing intent {intentId} named {intentName} of bot {botId} ({botVersion}, {localeId}).
        slots:
          slotPriorities: requestBody.slotPriorities
          intentId: path.intentId
          intentName: requestBody.intentName
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an intent
      effect: destructive
      questions:
      - How do I remove an intent from my bot?
      - Does deleting an intent also delete its slots?
      instructions:
      - text: Delete intent {intentId} from bot {botId} version {botVersion}, locale {localeId}.
        slots:
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Remove intent {intentId} and its slots on bot {botId} ({botVersion}, {localeId}).
        slots:
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}/slots'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a slot to an intent
      effect: write
      questions:
      - How do I make my intent collect a value like pizza size or crust?
      - Can a new slot accept multiple values or be obfuscated in logs?
      instructions:
      - text: Create slot {slotName} of type {slotTypeId} on intent {intentId}, bot {botId} ({botVersion}, {localeId}), prompting via {valueElicitationSetting}.
        slots:
          slotName: requestBody.slotName
          slotTypeId: requestBody.slotTypeId
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          valueElicitationSetting: requestBody.valueElicitationSetting
      - text: Add slot {slotName} to intent {intentId} of bot {botId} ({botVersion}, {localeId}) using prompt settings {valueElicitationSetting}.
        slots:
          slotName: requestBody.slotName
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          valueElicitationSetting: requestBody.valueElicitationSetting
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}/slots'].post
  update:
    x-apievangelist-phrasing:
      intent: List the slots in an intent
      effect: read
      questions:
      - Which slots does one of my intents collect?
      - Can I filter or sort the slots belonging to an intent?
      instructions:
      - text: List the slots in intent {intentId} of bot {botId} version {botVersion}, locale {localeId}.
        slots:
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show slots on intent {intentId} for bot {botId} ({botVersion}, {localeId}) sorted by {sortBy}.
        slots:
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          sortBy: requestBody.sortBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}/slots/{slotId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's details
      effect: read
      questions:
      - What prompts and slot type does a particular slot use?
      - Can I inspect the configuration of one slot in an intent?
      instructions:
      - text: Describe slot {slotId} in intent {intentId} of bot {botId} version {botVersion}, locale {localeId}.
        slots:
          slotId: path.slotId
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show how slot {slotId} is prompted and typed within intent {intentId}, bot {botId} ({botVersion}, {localeId}).
        slots:
          slotId: path.slotId
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}/slots/{slotId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing slot
      effect: write
      questions:
      - How do I change the prompt or slot type of an existing slot?
      - Can I turn on obfuscation for a slot that's already defined?
      instructions:
      - text: Update slot {slotId} ({slotName}) on intent {intentId} of bot {botId} version {botVersion}, locale {localeId}, with elicitation {valueElicitationSetting}.
        slots:
          slotId: path.slotId
          slotName: requestBody.slotName
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          valueElicitationSetting: requestBody.valueElicitationSetting
      - text: Obfuscate slot {slotId} ({slotName}) with {obfuscationSetting}, intent {intentId}, bot {botId} ({botVersion}, {localeId}), prompts {valueElicitationSetting}.
        slots:
          obfuscationSetting: requestBody.obfuscationSetting
          slotId: path.slotId
          slotName: requestBody.slotName
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          valueElicitationSetting: requestBody.valueElicitationSetting
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/intents/{intentId}/slots/{slotId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a slot from an intent
      effect: destructive
      questions:
      - How do I remove a slot my intent no longer needs?
      - Can I delete a single slot without touching the rest of the intent?
      instructions:
      - text: Delete slot {slotId} from intent {intentId} in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          slotId: path.slotId
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Remove slot {slotId} on intent {intentId} of bot {botId} ({botVersion}, {localeId}).
        slots:
          slotId: path.slotId
          intentId: path.intentId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/slottypes'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a custom slot type
      effect: write
      questions:
      - How do I define a custom list of allowed values, like crust types, for a slot?
      - Can a custom slot type extend a built-in type or pull values from an external grammar?
      instructions:
      - text: Create slot type {slotTypeName} with values {slotTypeValues} in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          slotTypeName: requestBody.slotTypeName
          slotTypeValues: requestBody.slotTypeValues
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Add a custom slot type {slotTypeName} based on {parentSlotTypeSignature} to bot {botId} ({botVersion}, {localeId}).
        slots:
          slotTypeName: requestBody.slotTypeName
          parentSlotTypeSignature: requestBody.parentSlotTypeSignature
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/slottypes'].post
  update:
    x-apievangelist-phrasing:
      intent: List a bot locale's slot types
      effect: read
      questions:
      - What custom slot types have I defined for a bot locale?
      - Can I filter the slot types in my bot by name?
      instructions:
      - text: List slot types in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show slot types on bot {botId} ({botVersion}, {localeId}) matching {filters}.
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/slottypes/{slotTypeId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot type's details
      effect: read
      questions:
      - What values and resolution strategy does a custom slot type have?
      - Can I look up one slot type's configuration?
      instructions:
      - text: Describe slot type {slotTypeId} in bot {botId} version {botVersion}, locale {localeId}.
        slots:
          slotTypeId: path.slotTypeId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Show the values defined for slot type {slotTypeId} on bot {botId} ({botVersion}, {localeId}).
        slots:
          slotTypeId: path.slotTypeId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/slottypes/{slotTypeId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom slot type
      effect: write
      questions:
      - How do I add new allowed values to a slot type I already created?
      - Can I change how an existing slot type resolves synonyms?
      instructions:
      - text: Update slot type {slotTypeId} ({slotTypeName}) in bot {botId} version {botVersion}, locale {localeId}, with values {slotTypeValues}.
        slots:
          slotTypeId: path.slotTypeId
          slotTypeName: requestBody.slotTypeName
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          slotTypeValues: requestBody.slotTypeValues
      - text: Set value selection {valueSelectionSetting} on existing slot type {slotTypeId} named {slotTypeName}, bot {botId} ({botVersion}, {localeId}).
        slots:
          valueSelectionSetting: requestBody.valueSelectionSetting
          slotTypeId: path.slotTypeId
          slotTypeName: requestBody.slotTypeName
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/slottypes/{slotTypeId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a slot type
      effect: destructive
      questions:
      - How do I delete a custom slot type from a bot locale?
      - What happens if I try to delete a slot type that slots still use?
      instructions:
      - text: Delete slot type {slotTypeId} from bot {botId} version {botVersion}, locale {localeId}.
        slots:
          slotTypeId: path.slotTypeId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
      - text: Force-delete slot type {slotTypeId} on bot {botId} ({botVersion}, {localeId}) with skipResourceInUseCheck {skipResourceInUseCheck}.
        slots:
          slotTypeId: path.slotTypeId
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          skipResourceInUseCheck: query.skipResourceInUseCheck
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/startgeneration'].put
  update:
    x-apievangelist-phrasing:
      intent: Generate a bot locale from a text description
      effect: write
      questions:
      - Can I describe my bot in plain English and have Lex generate the intents and slots?
      - How do I use the descriptive bot builder to draft a locale configuration?
      instructions:
      - text: Generate a bot configuration for locale {localeId} of bot {botId} version {botVersion} from the prompt {generationInputPrompt}.
        slots:
          localeId: path.localeId
          botId: path.botId
          botVersion: path.botVersion
          generationInputPrompt: requestBody.generationInputPrompt
      - text: 'Build intents and slots for bot {botId} ({botVersion}, {localeId}) from this description: {generationInputPrompt}.'
        slots:
          botId: path.botId
          botVersion: path.botVersion
          localeId: path.localeId
          generationInputPrompt: requestBody.generationInputPrompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/replicas'].put
  update:
    x-apievangelist-phrasing:
      intent: Replicate a bot to a secondary region
      effect: write
      questions:
      - How do I replicate my bot into another AWS region for resiliency?
      - Can I set up a copy of a bot in a secondary region?
      instructions:
      - text: Replicate bot {botId} to region {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: requestBody.replicaRegion
      - text: Create a replica of bot {botId} in {replicaRegion} for Global Resiliency.
        slots:
          botId: path.botId
          replicaRegion: requestBody.replicaRegion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/replicas'].post
  update:
    x-apievangelist-phrasing:
      intent: List a bot's regional replicas
      effect: read
      questions:
      - Which regions has my bot been replicated to?
      - Can I see all the replicas of a source bot?
      instructions:
      - text: List the replicas of bot {botId}.
        slots:
          botId: path.botId
      - text: Show every region where bot {botId} is replicated.
        slots:
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/replicas/{replicaRegion}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a bot replica's status
      effect: read
      questions:
      - Is my bot's replication to a secondary region complete?
      - What's the replication status of a bot in one particular region?
      instructions:
      - text: Describe the replica of bot {botId} in {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
      - text: Check replication status for bot {botId} in region {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/replicas/{replicaRegion}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a bot's replica in a region
      effect: destructive
      questions:
      - How do I stop replicating my bot to a secondary region and remove the copy?
      - Can I delete the replicated bot in one region only?
      instructions:
      - text: Delete the replica of bot {botId} in {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
      - text: Remove bot {botId}'s replicated copy from region {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/replicas/{replicaRegion}/botaliases'].post
  update:
    x-apievangelist-phrasing:
      intent: List replicated aliases in a region
      effect: read
      questions:
      - Which of my bot's aliases have been replicated to a secondary region?
      - Can I check alias replication status in the replica region?
      instructions:
      - text: List replicated aliases for bot {botId} in {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
      - text: Show alias replicas of bot {botId} in region {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/replicas/{replicaRegion}/botversions'].post
  update:
    x-apievangelist-phrasing:
      intent: List replicated bot versions in a region
      effect: read
      questions:
      - Which versions of my bot have replicated to the secondary region?
      - What's the replication status of each bot version for Global Resiliency?
      instructions:
      - text: List replicated versions of bot {botId} in {replicaRegion}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
      - text: Show version replication statuses for bot {botId} in region {replicaRegion}, sorted by {sortBy}.
        slots:
          botId: path.botId
          replicaRegion: path.replicaRegion
          sortBy: requestBody.sortBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/utterances'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete stored user utterances
      effect: destructive
      questions:
      - How do I delete the utterances Lex stored from a user's conversation?
      - Can I erase stored utterances for just one session or one locale?
      instructions:
      - text: Delete stored utterances for bot {botId}.
        slots:
          botId: path.botId
      - text: Erase the utterances stored from session {sessionId} in locale {localeId} of bot {botId}.
        slots:
          sessionId: query.sessionId
          localeId: query.localeId
          botId: path.botId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botAliases/{botAliasId}/botLocales/{localeId}/sessions/{sessionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's conversation session state
      effect: read
      questions:
      - Can I see where a user left off in a long-running conversation with my bot?
      - What intent and slot values are in a user's current session?
      instructions:
      - text: Get session {sessionId} for bot {botId}, alias {botAliasId}, locale {localeId}.
        slots:
          sessionId: path.sessionId
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
      - text: Show the current state of user session {sessionId} on bot {botId} ({botAliasId}, {localeId}).
        slots:
          sessionId: path.sessionId
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botAliases/{botAliasId}/botLocales/{localeId}/sessions/{sessionId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or set a conversation session's state
      effect: write
      questions:
      - How do I set the dialog state of a user's session from my application?
      - Can my app start a session with the bot already in a particular intent?
      instructions:
      - text: Set session {sessionId} on bot {botId}, alias {botAliasId}, locale {localeId} to state {sessionState}.
        slots:
          sessionId: path.sessionId
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
          sessionState: requestBody.sessionState
      - text: Create session {sessionId} for bot {botId} ({botAliasId}, {localeId}) with state {sessionState} and messages {messages}.
        slots:
          sessionId: path.sessionId
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
          sessionState: requestBody.sessionState
          messages: requestBody.messages
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botAliases/{botAliasId}/botLocales/{localeId}/sessions/{sessionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reset a user's conversation session
      effect: destructive
      questions:
      - How do I restart a conversation with my bot by clearing the session?
      - Does removing a session wipe its whole history?
      instructions:
      - text: Delete session {sessionId} on bot {botId}, alias {botAliasId}, locale {localeId}.
        slots:
          sessionId: path.sessionId
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
      - text: Clear user session {sessionId} for bot {botId} ({botAliasId}, {localeId}) so the conversation starts over.
        slots:
          sessionId: path.sessionId
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botAliases/{botAliasId}/botLocales/{localeId}/sessions/{sessionId}/conversation'].post
  update:
    x-apievangelist-phrasing:
      intent: Stream a real-time audio or text conversation
      effect: write
      questions:
      - Can I stream live audio or DTMF keypresses to my bot over a bidirectional connection?
      - What audio format does a streaming conversation with the bot expect?
      instructions:
      - text: Start a streaming conversation for session {sessionId} with bot {botId}, alias {botAliasId}, locale {localeId}.
        slots:
          sessionId: path.sessionId
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
      - text: Open an HTTP/2 event stream to bot {botId} ({botAliasId}, {localeId}) for session {sessionId} in {conversationMode} mode.
        slots:
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
          sessionId: path.sessionId
          conversationMode: header.x-amz-lex-conversation-mode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botAliases/{botAliasId}/botLocales/{localeId}/sessions/{sessionId}/text'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a text message to a bot
      effect: write
      questions:
      - How do I send a user's typed message to my bot and get its reply?
      - Can I pass session attributes along with a text message to the bot?
      instructions:
      - text: Send the text {text} to bot {botId}, alias {botAliasId}, locale {localeId}, in session {sessionId}.
        slots:
          text: requestBody.text
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
          sessionId: path.sessionId
      - text: Ask bot {botId} ({botAliasId}, {localeId}) "{text}" as session {sessionId} and return its interpretation.
        slots:
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
          text: requestBody.text
          sessionId: path.sessionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bots/{botId}/botAliases/{botAliasId}/botLocales/{localeId}/sessions/{sessionId}/utterance'].post
  update:
    x-apievangelist-phrasing:
      intent: Send speech or text as a single utterance
      effect: write
      questions:
      - How do I send a recorded audio clip to my bot and get a spoken response back?
      - Which fields have to be gzipped and base64 encoded when sending an utterance?
      instructions:
      - text: Send an audio utterance of type {contentType} to bot {botId}, alias {botAliasId}, locale {localeId}, session {sessionId}.
        slots:
          contentType: header.Content-Type
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
          sessionId: path.sessionId
      - text: Submit a {contentType} utterance to bot {botId} ({botAliasId}, {localeId}) for session {sessionId} and return audio as {responseContentType}.
        slots:
          contentType: header.Content-Type
          botId: path.botId
          botAliasId: path.botAliasId
          localeId: path.localeId
          sessionId: path.sessionId
          responseContentType: header.Response-Content-Type
      method: generated
      generated: '2026-09-26'