# 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'