# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.DirectoryManagement Subscribed Skus.subscribed Sku…
  version: 1.0.0
extends: openapi/azure-ad-subscribedskus-subscribedsku-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/subscribedSkus'].get
  update:
    x-apievangelist-phrasing:
      intent: List the organization's license subscriptions
      effect: read
      questions:
      - Which commercial subscriptions and licenses has my organization acquired?
      - How many license units are consumed versus prepaid across my subscriptions?
      instructions:
      - text: List every subscribed SKU for the organization.
      - text: Show my license subscriptions with {fields} only.
        slots:
          fields: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscribedSkus'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a subscribed SKU entity
      effect: write
      questions:
      - Can I add a subscribed SKU record with a SKU id and part number?
      - What fields make up a new subscribed SKU, such as prepaid and consumed units?
      instructions:
      - text: Add a subscribed SKU with SKU id {sku} and part number {part}.
        slots:
          sku: requestBody.skuId
          part: requestBody.skuPartNumber
      - text: Create a subscribed SKU for account {account} that applies to {appliesTo}.
        slots:
          account: requestBody.accountId
          appliesTo: requestBody.appliesTo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscribedSkus/{subscribedSku-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one license subscription
      effect: read
      questions:
      - What are the details of one specific commercial subscription my organization owns?
      - Is a particular subscription enabled, and which service plans does it include?
      instructions:
      - text: Get subscribed SKU {sku}.
        slots:
          sku: path.subscribedSku-id
      - text: Show consumed and prepaid units for subscription {sku}.
        slots:
          sku: path.subscribedSku-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscribedSkus/{subscribedSku-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subscribed SKU entity
      effect: destructive
      questions:
      - Can I delete a subscribed SKU record from the directory?
      - Is removing a subscribed SKU entry reversible?
      instructions:
      - text: Delete subscribed SKU {sku}.
        slots:
          sku: path.subscribedSku-id
      - text: Remove the subscription record {sku} from subscribedSkus.
        slots:
          sku: path.subscribedSku-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscribedSkus/{subscribedSku-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a subscribed SKU entity
      effect: write
      questions:
      - Can I change the capability status of a subscribed SKU?
      - Which properties of an existing subscribed SKU can be edited?
      instructions:
      - text: Set the capability status of subscribed SKU {sku} to {status}.
        slots:
          sku: path.subscribedSku-id
          status: requestBody.capabilityStatus
      - text: Update the service plans on subscription {sku} to {plans}.
        slots:
          sku: path.subscribedSku-id
          plans: requestBody.servicePlans
      method: generated
      generated: '2026-10-01'