# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Reactor Extension packages API
  version: 1.0.0
extends: openapi/adobe-suite-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: 6
- target: $.paths['/extension_packages'].get
  update:
    x-apievangelist-phrasing:
      intent: List tag extension packages
      effect: read
      questions:
      - How do I browse the extension packages available for Adobe Experience Platform tags?
      - Can I filter extension packages by platform, status or name?
      - Is the extension package list paginated?
      instructions:
      - text: List extension packages named {name}.
        slots:
          name: query.name
      - text: List {platform} extension packages with status {status}.
        slots:
          platform: query.platform
          status: query.status
      - text: Show page {page_number} of extension packages at {page_size} per page.
        slots:
          page_number: query.page[number]
          page_size: query.page[size]
      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 publish a new tag extension by uploading its package file?
      - Does creating an extension package take JSON or a file upload?
      instructions:
      - text: Create an extension package from the archive {package}.
        slots:
          package: requestBody.package
      - text: Upload {package} as a new extension 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 one extension package
      effect: read
      questions:
      - How do I look up the details of a single extension package?
      - What status is my extension package in right now?
      instructions:
      - text: Show extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Get the details and 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 extension 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 been released privately?
      instructions:
      - text: Update development extension package {EXTENSION_PACKAGE_ID} with archive {package}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
          package: requestBody.package
      - text: Re-upload {package} to extension package {EXTENSION_PACKAGE_ID}.
        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: Privately release or discontinue an extension package
      effect: write
      questions:
      - How do I release my extension package privately to every property in my company?
      - Can I discontinue an extension package I released earlier?
      instructions:
      - text: Privately release extension package {EXTENSION_PACKAGE_ID} using payload {data}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
          data: requestBody.data
      - text: Discontinue extension package {EXTENSION_PACKAGE_ID} with {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: List versions of an extension package
      effect: read
      questions:
      - What versions exist for a given extension package?
      - How do I see the release history of an extension package?
      instructions:
      - text: List the versions of extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Show every released version of extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      method: generated
      generated: '2026-09-26'