# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Reactor Extensions API
  version: 1.0.0
extends: openapi/adobe-suite-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: 12
- target: $.paths['/properties/{PROPERTY_ID}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List the extensions installed on a property
      effect: read
      questions:
      - Which extensions are installed on my Adobe tags property?
      - Can I show only enabled extensions, or filter by version?
      - How do I find extensions in a property that have been published?
      instructions:
      - text: List the extensions on property {property}.
        slots:
          property: path.PROPERTY_ID
      - text: Show extensions on property {property} named {name}.
        slots:
          property: path.PROPERTY_ID
          name: query.name
      - text: 'List extensions on property {property} that are enabled: {enabled}.'
        slots:
          property: path.PROPERTY_ID
          enabled: query.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/extensions'].post
  update:
    x-apievangelist-phrasing:
      intent: Install an extension on a property
      effect: write
      questions:
      - How do I install an extension package onto a tags property?
      - What do I send to add a new extension to a property?
      instructions:
      - text: Install an extension on property {property}.
        slots:
          property: path.PROPERTY_ID
      - text: Add extension {data} to property {property}.
        slots:
          property: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an extension's details
      effect: read
      questions:
      - How do I look up one installed extension by ID?
      - What settings does an installed extension currently have?
      instructions:
      - text: Show me extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Get the settings of extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Uninstall an extension
      effect: destructive
      questions:
      - How do I remove an extension from a tags property for good?
      - Can I delete an installed extension via the API?
      instructions:
      - text: Delete extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Uninstall extension {extension} from its property.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create a new revision of an extension
      effect: write
      questions:
      - How do I save a new revision of an extension with updated settings?
      - Does revising an extension give the revision its own ID?
      instructions:
      - text: Revise extension {extension} with {data}.
        slots:
          extension: path.EXTENSION_ID
          data: requestBody.data
      - text: Make a new revision of extension {extension}.
        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 version is this installed extension based on?
      - How do I see the package definition an extension was installed from?
      instructions:
      - text: Show the extension package for extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Get the package that extension {extension} was installed from.
        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?
      - Will removing an extension affect any libraries?
      instructions:
      - text: List the libraries that use extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Find every library including extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find which property an extension is on
      effect: read
      questions:
      - What property is this extension installed on?
      - How do I go from an extension to its parent property?
      instructions:
      - text: Show the property of extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Get the parent property for extension {extension}.
        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 original extension of a revision
      effect: read
      questions:
      - How do I find the original extension that a revision came from?
      - Can I trace an extension revision back to its origin?
      instructions:
      - text: Show the origin of extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Get the original extension that revision {extension} was made 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 revisions have been made to this extension over time?
      - Can I page through an extension's revision history?
      instructions:
      - text: List the revisions of extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Show the revision history for extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extensions/{EXTENSION_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List the notes on an extension
      effect: read
      questions:
      - What notes has my team left on this extension?
      - Is there any documentation attached to an extension as notes?
      instructions:
      - text: List the notes on extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Show the comments left on extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      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 write a note on an extension?
      - Can I attach a comment to an extension for other admins?
      instructions:
      - text: Add a note to extension {extension}.
        slots:
          extension: path.EXTENSION_ID
      - text: Write a note on extension {extension} explaining its setup.
        slots:
          extension: path.EXTENSION_ID
      method: generated
      generated: '2026-09-26'