# 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 package usage authorization API
  version: 1.0.0
extends: openapi/adobe-launch-extension-package-usage-authorization-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/{EXTENSION_PACKAGE_ID}/extension_package_usage_authorizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List usage authorizations for a package
      effect: read
      questions:
      - Which organizations are authorized to use my private extension package?
      - Can I see all usage authorizations granted on one extension package?
      instructions:
      - text: List usage authorizations for extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Show who can use 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}/extension_package_usage_authorizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Authorize an org to use an extension package
      effect: write
      questions:
      - How do I share my private extension package with another organization?
      - Can I grant usage of an extension package to a different org?
      instructions:
      - text: Create a usage authorization for extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      - text: Authorize the organization in {data} to use extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_package_usage_authorizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List all extension package usage authorizations
      effect: read
      questions:
      - What extension package usage authorizations exist across my organization?
      - Can I list every usage authorization without naming a package first?
      instructions:
      - text: List all extension package usage authorizations for IMS org {org_id}.
        slots:
          org_id: header.x-gw-ims-org-id
      - text: Show every extension package authorization my org has granted or received.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_package_usage_authorizations/{ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke an extension package usage authorization
      effect: destructive
      questions:
      - How do I stop another org from using my extension package?
      - Can I delete a usage authorization I granted earlier?
      instructions:
      - text: Delete extension package usage authorization {ID}.
        slots:
          ID: path.ID
      - text: Revoke usage authorization {ID} for our extension package.
        slots:
          ID: path.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_package_usage_authorizations/{ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an extension package usage authorization
      effect: write
      questions:
      - How do I modify a usage authorization on an extension package?
      - Can I change an existing usage authorization instead of deleting it?
      instructions:
      - text: Update extension package usage authorization {ID} with {data}.
        slots:
          ID: path.ID
          data: requestBody.data
      - text: Change the settings of usage authorization {ID}.
        slots:
          ID: path.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_package_usage_authorizations/{EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID}/extension_package'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the package behind a usage authorization
      effect: read
      questions:
      - Which extension package does a usage authorization cover?
      - How can I see the package details for an authorization I received?
      instructions:
      - text: Get the extension package for usage authorization {EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID}.
        slots:
          EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID: path.EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID
      - text: Show which package authorization {EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID} grants access to.
        slots:
          EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID: path.EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID
      method: generated
      generated: '2026-09-26'