# 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 Model Building V2 Exports API
  version: 1.0.0
extends: openapi/amazon-lex-exports-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: 5
- target: $.paths['/exports'].put
  update:
    x-apievangelist-phrasing:
      intent: Export a bot or locale to a zip archive
      effect: write
      questions:
      - How do I export my Lex bot definition as a zip file of JSON?
      - Can I password-protect a bot export archive?
      instructions:
      - text: Export {resourceSpecification} as a {fileFormat} archive.
        slots:
          resourceSpecification: requestBody.resourceSpecification
          fileFormat: requestBody.fileFormat
      - text: Create a {fileFormat} export of {resourceSpecification} protected with password {filePassword}.
        slots:
          fileFormat: requestBody.fileFormat
          resourceSpecification: requestBody.resourceSpecification
          filePassword: requestBody.filePassword
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exports'].post
  update:
    x-apievangelist-phrasing:
      intent: List recent bot exports
      effect: read
      questions:
      - Which bot exports have I made in the last week?
      - Can I filter exports down to one bot and locale?
      instructions:
      - text: List my recent exports.
      - text: Show exports of bot {botId} version {botVersion} for locale {localeId}.
        slots:
          botId: requestBody.botId
          botVersion: requestBody.botVersion
          localeId: requestBody.localeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exports/{exportId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an export's status and download link
      effect: read
      questions:
      - Is my bot export finished, and where do I download it?
      - What's the status of a specific export job?
      instructions:
      - text: Describe export {exportId}.
        slots:
          exportId: path.exportId
      - text: Get the status and download URL for export {exportId}.
        slots:
          exportId: path.exportId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exports/{exportId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change the password on an export archive
      effect: write
      questions:
      - How do I change the password on a bot export zip?
      - Can I remove password protection from an export I already created?
      instructions:
      - text: Set the password on export {exportId} to {filePassword}.
        slots:
          exportId: path.exportId
          filePassword: requestBody.filePassword
      - text: Update export {exportId} so its archive is not password protected.
        slots:
          exportId: path.exportId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exports/{exportId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an export and its files
      effect: destructive
      questions:
      - How do I delete a previous bot export and its S3 files?
      - Can I clean up an export archive I no longer need?
      instructions:
      - text: Delete export {exportId}.
        slots:
          exportId: path.exportId
      - text: Remove export {exportId} along with its stored archive.
        slots:
          exportId: path.exportId
      method: generated
      generated: '2026-09-26'