API Evangelist conversational phrasing for Twilio Marketplace API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Marketplace API
  version: 1.0.0
extends: openapi/twilio-marketplace-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: 12
- target: $.paths['/marketplace/AvailableAddOns/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: View an add-on available to install
      effect: read
      questions:
      - What does a particular marketplace add-on do before I install it?
      - Can I read the configuration schema of an add-on I haven't installed yet?
      instructions:
      - text: Show the marketplace listing for available add-on {addon_sid}.
        slots:
          addon_sid: path.Sid
      - text: Fetch details of uninstalled add-on {addon_sid}.
        slots:
          addon_sid: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/AvailableAddOns'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse add-ons available in the marketplace
      effect: read
      questions:
      - Which add-ons can I install from the marketplace?
      - What third-party add-ons are offered for my account to choose from?
      instructions:
      - text: List every add-on available to install from the marketplace.
      - text: Browse the marketplace catalog, {page_size} add-ons per page.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/AvailableAddOns/{AvailableAddOnSid}/Extensions/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: View one extension of an available add-on
      effect: read
      questions:
      - Which product does a specific extension of a marketplace add-on hook into?
      - Can I inspect one extension of an add-on before installing it?
      instructions:
      - text: Fetch extension {extension_sid} of available add-on {addon_sid}.
        slots:
          extension_sid: path.Sid
          addon_sid: path.AvailableAddOnSid
      - text: Show what extension {extension_sid} does on uninstalled add-on {addon_sid}.
        slots:
          extension_sid: path.Sid
          addon_sid: path.AvailableAddOnSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/AvailableAddOns/{AvailableAddOnSid}/Extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List extensions offered by an available add-on
      effect: read
      questions:
      - What extensions come with a marketplace add-on I'm considering?
      - Where does an available add-on plug into my messaging or voice flows?
      instructions:
      - text: List the extensions offered by available add-on {addon_sid}.
        slots:
          addon_sid: path.AvailableAddOnSid
      - text: Show every extension that marketplace add-on {addon_sid} would provide.
        slots:
          addon_sid: path.AvailableAddOnSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns'].get
  update:
    x-apievangelist-phrasing:
      intent: List add-ons installed on my account
      effect: read
      questions:
      - Which marketplace add-ons have I already installed?
      - Can I see all installed add-ons on this account at once?
      instructions:
      - text: List the add-ons installed on my account.
      - text: Show my installed add-ons, {page_size} per page.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns'].post
  update:
    x-apievangelist-phrasing:
      intent: Install a marketplace add-on
      effect: write
      questions:
      - How do I install an add-on from the marketplace?
      - Do I have to accept the terms of service to install an add-on?
      instructions:
      - text: Install add-on {addon_sid} and accept its terms of service ({accept_tos}).
        slots:
          addon_sid: requestBody.AvailableAddOnSid
          accept_tos: requestBody.AcceptTermsOfService
      - text: Install add-on {addon_sid} as {unique_name} with terms accepted {accept_tos} and configuration {configuration}.
        slots:
          addon_sid: requestBody.AvailableAddOnSid
          unique_name: requestBody.UniqueName
          accept_tos: requestBody.AcceptTermsOfService
          configuration: requestBody.Configuration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: View an installed add-on
      effect: read
      questions:
      - What configuration is an installed add-on currently running with?
      - Can I look up one add-on that's already installed on my account?
      instructions:
      - text: Fetch installed add-on {installed_sid}.
        slots:
          installed_sid: path.Sid
      - text: Show the current configuration of my installed add-on {installed_sid}.
        slots:
          installed_sid: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Reconfigure an installed add-on
      effect: write
      questions:
      - Can I change the settings of an add-on after installing it?
      - Is renaming an installed add-on's unique name allowed?
      instructions:
      - text: Update installed add-on {installed_sid} with configuration {configuration}.
        slots:
          installed_sid: path.Sid
          configuration: requestBody.Configuration
      - text: Rename installed add-on {installed_sid} to {unique_name}.
        slots:
          installed_sid: path.Sid
          unique_name: requestBody.UniqueName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Uninstall a marketplace add-on
      effect: destructive
      questions:
      - Can I uninstall an add-on I no longer use?
      - What removes an add-on installation from my account?
      instructions:
      - text: Uninstall add-on {installed_sid}.
        slots:
          installed_sid: path.Sid
      - text: Remove the installed add-on {installed_sid} from my account.
        slots:
          installed_sid: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns/{InstalledAddOnSid}/Extensions/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: View an extension of an installed add-on
      effect: read
      questions:
      - Is a particular extension of my installed add-on switched on?
      - Can I check one extension on an add-on I've installed?
      instructions:
      - text: Fetch extension {extension_sid} of installed add-on {installed_sid}.
        slots:
          extension_sid: path.Sid
          installed_sid: path.InstalledAddOnSid
      - text: Show whether extension {extension_sid} is enabled on my add-on {installed_sid}.
        slots:
          extension_sid: path.Sid
          installed_sid: path.InstalledAddOnSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns/{InstalledAddOnSid}/Extensions/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn an installed add-on's extension on or off
      effect: write
      questions:
      - Can I disable one extension of an add-on without uninstalling it?
      - What controls whether an installed add-on extension gets invoked?
      instructions:
      - text: Set extension {extension_sid} on installed add-on {installed_sid} to enabled {enabled}.
        slots:
          extension_sid: path.Sid
          installed_sid: path.InstalledAddOnSid
          enabled: requestBody.Enabled
      - text: Turn off extension {extension_sid} of my installed add-on {installed_sid} by setting enabled to {enabled}.
        slots:
          extension_sid: path.Sid
          installed_sid: path.InstalledAddOnSid
          enabled: requestBody.Enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/InstalledAddOns/{InstalledAddOnSid}/Extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List extensions of an installed add-on
      effect: read
      questions:
      - Which extensions does my installed add-on have and which are active?
      - Where can I see every extension attached to an add-on I installed?
      instructions:
      - text: List the extensions of installed add-on {installed_sid}.
        slots:
          installed_sid: path.InstalledAddOnSid
      - text: Show all extensions on my installed add-on {installed_sid} with their enabled state.
        slots:
          installed_sid: path.InstalledAddOnSid
      method: generated
      generated: '2026-09-26'