# 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-suite-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 an extension package
      effect: read
      questions:
      - Which organizations are authorized to use one of my private tag extension packages?
      - How do I see the usage authorizations granted on a specific 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 organization to use an extension package
      effect: write
      questions:
      - How do I share a private extension package with another organization?
      - Can I grant usage of my extension package to a new org?
      instructions:
      - text: Authorize use of extension package {EXTENSION_PACKAGE_ID} with {data}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
          data: requestBody.data
      - text: Create a usage authorization on extension package {EXTENSION_PACKAGE_ID}.
        slots:
          EXTENSION_PACKAGE_ID: path.EXTENSION_PACKAGE_ID
      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:
      - Which extension package usage authorizations involve my organization?
      - Is there one list of every extension package authorization across packages?
      instructions:
      - text: List all extension package usage authorizations.
      - text: Show every extension package authorization that IMS org {org} has sent or received.
        slots:
          org: header.x-gw-ims-org-id
      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 revoke another org's access to my extension package?
      - Can I delete a usage authorization I granted by mistake?
      instructions:
      - text: Delete extension package usage authorization {ID}.
        slots:
          ID: path.ID
      - text: Revoke usage authorization {ID}.
        slots:
          ID: path.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/extension_package_usage_authorizations/{ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Approve or change a usage authorization
      effect: write
      questions:
      - Can I accept or reject an extension package authorization that was offered to my org?
      - How do I update the state of an existing usage authorization?
      instructions:
      - text: Update usage authorization {ID} with {data}.
        slots:
          ID: path.ID
          data: requestBody.data
      - text: Change the state of extension package 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 given usage authorization refer to?
      - Can I see the package details from an authorization I received?
      instructions:
      - text: Show the extension package for authorization {EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID}.
        slots:
          EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID: path.EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID
      - text: Get package data behind usage authorization {EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID}.
        slots:
          EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID: path.EXTENSION_PACKAGE_USAGE_AUTHORIZATION_ID
      method: generated
      generated: '2026-09-26'