# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Launch Extensions API
  version: 1.0.0
extends: openapi/adobe-launch-extensions-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: 22
- target: $.paths['/properties/{PROPERTY_ID}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag property's extensions
      effect: read
      questions:
      - Which extensions are installed on my Adobe tags property?
      - Can I filter a property's extensions to only enabled or published ones?
      - How do I find which version of an extension a property is running?
      instructions:
      - text: List the extensions installed on property {property}.
        slots:
          property: path.PROPERTY_ID
      - text: Show extensions on property {property} with display name {display_name}.
        slots:
          property: path.PROPERTY_ID
          display_name: query.display_name
      - text: List only the enabled extensions on property {property}.
        slots:
          property: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/extensions'].post
  update:
    x-apievangelist-phrasing:
      intent: Install an extension on a tag property
      effect: write
      questions:
      - What's needed to add an extension to a tags property?
      - Does installing an extension require a link to its extension package?
      instructions:
      - text: Create an extension on property {property} with {data}.
        slots:
          property: path.PROPERTY_ID
          data: requestBody.data
      - text: Add a new extension to tags property {property} using the uppercase PROPERTY_ID endpoint.
        slots:
          property: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an extension by ID
      effect: read
      questions:
      - Where can I see one extension's settings and version?
      - Can I check whether an extension is enabled?
      instructions:
      - text: Get the details of extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Show me the settings of extension {extension} from the uppercase-ID endpoint.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an extension
      effect: destructive
      questions:
      - How do I uninstall an extension from a tags property?
      - What happens to rules that use an extension I delete?
      instructions:
      - text: Delete extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Uninstall extension {extension} via the uppercase EXTENSION_ID endpoint.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Revise an extension's settings
      effect: write
      questions:
      - How do I change an extension's settings, and does it create a new revision?
      - Does a revised extension get a new ID?
      instructions:
      - text: Revise extension {extension} with the new settings {data}.
        slots:
          extension: path.EXTENSION_ID
          data: requestBody.data
      - text: Create a new revision of extension {extension} through the uppercase-ID PATCH.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/extension_package'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the package behind an extension
      effect: read
      questions:
      - Which extension package was this installed extension built from?
      - Can I look up the package version of an installed extension?
      instructions:
      - text: Show the extension package for extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Look up which package extension {extension} came from using the uppercase-ID endpoint.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/libraries'].get
  update:
    x-apievangelist-phrasing:
      intent: List libraries that use an extension
      effect: read
      questions:
      - Which libraries include this extension?
      - Before changing an extension, can I see what libraries it's in?
      instructions:
      - text: List the libraries that use extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Show page {page} of libraries containing extension {extension}.
        slots:
          extension: path.EXTENSION_ID
          page: query.page[number]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the property an extension belongs to
      effect: read
      questions:
      - Which property is this extension installed on?
      - Can I go from an extension ID back to its property?
      instructions:
      - text: Show the property that extension {extension} belongs to.
        slots:
          extension: path.EXTENSION_ID
      - text: Look up the parent property of extension {extension} via the uppercase-ID endpoint.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/origin'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the origin revision of an extension
      effect: read
      questions:
      - Where did this extension revision originate from?
      - Can I find the original extension a revision was made from?
      instructions:
      - text: Get the origin of extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Show the original extension that revision {extension} came from.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an extension's revisions
      effect: read
      questions:
      - What's the revision history of this extension?
      - Can I page through every revision of an extension?
      instructions:
      - text: List the revisions of extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Show {size} revisions per page for extension {extension}.
        slots:
          extension: path.EXTENSION_ID
          size: query.page[size]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List notes on an extension
      effect: read
      questions:
      - What notes have been left on this extension?
      - Can I page through an extension's notes?
      instructions:
      - text: List the notes on extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Show page {page} of notes for extension {extension}.
        slots:
          extension: path.EXTENSION_ID
          page: query.page[number]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/notes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to an extension
      effect: write
      questions:
      - How do I leave a comment on an extension for my team?
      - Can I attach a note explaining why an extension was configured a certain way?
      instructions:
      - text: Add a note to extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Leave a configuration note on extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List extensions on an event forwarding property
      effect: read
      questions:
      - Which extensions are installed in my event forwarding property?
      - Can I page through event forwarding extensions?
      instructions:
      - text: List the extensions in event forwarding property {property}.
        slots:
          property: path.propertyId
      - text: Show page {page} of extensions for event forwarding property {property}.
        slots:
          property: path.propertyId
          page: query.page[number]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/extensions'].post
  update:
    x-apievangelist-phrasing:
      intent: Install an extension from a package
      effect: write
      questions:
      - How do I install an extension from an extension package into an event forwarding property?
      - Which relationship must I include when installing an extension package?
      instructions:
      - text: Install extension package {data} into property {property}.
        slots:
          property: path.propertyId
          data: requestBody.data
      - text: Install an extension from its package into event forwarding property {property}.
        slots:
          property: path.propertyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an installed extension (alternate)
      effect: read
      questions:
      - Can I still retrieve an extension after it was deleted?
      - How do I tell if an installed extension has a deleted_at date?
      instructions:
      - text: Look up installed extension {extensionId} using the extensionId endpoint.
        slots:
          extensionId: path.extensionId
      - text: Check whether installed extension {extensionId} has been deleted.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an installed extension (alternate)
      effect: destructive
      questions:
      - What response do I get when removing an installed extension through the extensionId endpoint?
      - Is there a camelCase endpoint for removing an event forwarding extension?
      instructions:
      - text: Remove installed extension {extensionId} via the extensionId endpoint.
        slots:
          extensionId: path.extensionId
      - text: Uninstall event forwarding extension {extensionId}.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Revise an installed extension (alternate)
      effect: write
      questions:
      - Do I have to set meta.action to revise when updating an installed extension's settings?
      - Can I revise an event forwarding extension's settings?
      instructions:
      - text: Revise installed extension {extensionId} with meta action revise and {data}.
        slots:
          extensionId: path.extensionId
          data: requestBody.data
      - text: Update the settings of event forwarding extension {extensionId}.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}/extension_package'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an installed extension's base package (alternate)
      effect: read
      questions:
      - What's the base extension package of an event forwarding extension?
      - Can I get the base package through the extensionId endpoint?
      instructions:
      - text: Get the base extension package of installed extension {extensionId}.
        slots:
          extensionId: path.extensionId
      - text: Show the package event forwarding extension {extensionId} was installed from.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an installed extension's version history
      effect: read
      questions:
      - What's the version history of an event forwarding extension?
      - Can I list revisions through the extensionId endpoint?
      instructions:
      - text: List the version history of installed extension {extensionId}.
        slots:
          extensionId: path.extensionId
      - text: Show all revisions of event forwarding extension {extensionId}.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}/libraries'].get
  update:
    x-apievangelist-phrasing:
      intent: List libraries including an extension (alternate)
      effect: read
      questions:
      - Which libraries include a given event forwarding extension?
      - Can I see an extension's libraries through the extensionId endpoint?
      instructions:
      - text: List libraries that include installed extension {extensionId}.
        slots:
          extensionId: path.extensionId
      - text: Show which event forwarding libraries contain extension {extensionId}.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}/origin'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the previous revision of an extension
      effect: read
      questions:
      - How do I get the previous revision of an installed extension?
      - Can I step back one revision on an event forwarding extension?
      instructions:
      - text: Get the previous revision of installed extension {extensionId}.
        slots:
          extensionId: path.extensionId
      - text: Show the revision event forwarding extension {extensionId} was made from.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{extensionId}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the property owning an extension (alternate)
      effect: read
      questions:
      - Which property owns an event forwarding extension?
      - Can I find an extension's owning property via the extensionId endpoint?
      instructions:
      - text: Get the property that owns installed extension {extensionId}.
        slots:
          extensionId: path.extensionId
      - text: Show the owning property of event forwarding extension {extensionId}.
        slots:
          extensionId: path.extensionId
      method: generated
      generated: '2026-09-26'