# 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 Extension packages API
  version: 1.0.0
extends: openapi/adobe-launch-extension-packages-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: 9
- target: $.paths['/extension_packages'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse available extension packages
      effect: read
      questions:
      - Which extension packages are available in the tags catalog?
      - Can I filter extension packages by platform, status or version?
      instructions:
      - text: List all extension packages.
      - text: Find extension packages with display name {display_name} on platform {platform}.
        slots:
          display_name: query.display_name
          platform: query.platform
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a new extension package
      effect: write
      questions:
      - How do I upload a new extension package I built?
      - Does creating an extension package take a file upload rather than JSON?
      instructions:
      - text: Upload extension package archive {package}.
        slots:
          package: requestBody.package
      - text: Create a development extension package from the zip file {package}.
        slots:
          package: requestBody.package
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages/{EXTENSION_PACKAGE_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag extension package
      effect: read
      questions:
      - How can I see the details and availability of one extension package?
      - Is a given extension package still in development or already released?
      instructions:
      - text: Retrieve extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Show the release status of extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages/{EXTENSION_PACKAGE_ID}'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace a development package's archive
      effect: write
      questions:
      - Can I upload a new archive to an extension package that is still in development?
      - Why can't I update an extension package after it has gone private or public?
      instructions:
      - text: Upload new archive {package} to development extension package {EXTENSION_PACKAGE_ID}.
        slots:
          package: requestBody.package
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Replace the zip of development package {EXTENSION_PACKAGE_ID} with {package}.
        slots:
          package: requestBody.package
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages/{EXTENSION_PACKAGE_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Release privately or discontinue a package
      effect: destructive
      questions:
      - How do I make my tested extension package available to every property in my company?
      - Can I discontinue an extension package I no longer support?
      instructions:
      - text: Privately release extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Discontinue extension package {EXTENSION_PACKAGE_ID} with payload {data}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages/{EXTENSION_PACKAGE_ID}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag extension package's versions
      effect: read
      questions:
      - What versions of an extension package have been published over time?
      - Can I see the version history of a tag extension package?
      instructions:
      - text: Retrieve the versions of extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Show every version of tag extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages/{extensionPackageId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an extension package by ID
      effect: read
      questions:
      - How do I fetch a specific extension package using its identifier?
      - Which platform and version is a particular extension package on?
      instructions:
      - text: Fetch extension package {extensionPackageId}.
        slots:
          extensionPackageId: path.extensionPackageId
      - text: Look up the platform and version of extension package {extensionPackageId}.
        slots:
          extensionPackageId: path.extensionPackageId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages/{extensionPackageId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update, release or discontinue a package
      effect: write
      questions:
      - Can one PATCH call both upload a new ZIP and privately release an extension package?
      - How do I mark an extension package as discontinued by patching it?
      instructions:
      - text: Patch extension package {extensionPackageId} with {data}.
        slots:
          extensionPackageId: path.extensionPackageId
          data: requestBody.data
      - text: Patch extension package {extensionPackageId} with new ZIP {package} and attributes {data}.
        slots:
          extensionPackageId: path.extensionPackageId
          package: requestBody.package
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_packages/{extensionPackageId}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List previous versions of an extension package
      effect: read
      questions:
      - Which earlier versions of an extension package exist?
      - Can I page through an extension package's past versions?
      instructions:
      - text: List previous versions of extension package {extensionPackageId}.
        slots:
          extensionPackageId: path.extensionPackageId
      - text: Show page {number} of past versions for extension package {extensionPackageId}.
        slots:
          extensionPackageId: path.extensionPackageId
          number: query.page[number]
      method: generated
      generated: '2026-09-26'