# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Products API
  version: 1.0.0
extends: openapi/microsoft-azure-products-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureBridge.Admin/activations/{activationName}/products'].get
  update:
    x-apievangelist-phrasing:
      intent: List marketplace products for an Azure Stack activation
      effect: read
      questions:
      - Which Azure Marketplace products are available to an Azure Stack bridge activation?
      - Can I see all syndicated marketplace items for my Azure Stack activation?
      instructions:
      - text: List the marketplace products available to Azure Stack activation {activationName}.
        slots:
          activationName: path.activationName
      - text: Show every product I can syndicate from Azure Marketplace to Azure Stack.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureBridge.Admin/activations/{activationName}/products/{productName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a marketplace product for an Azure Stack activation
      effect: read
      questions:
      - What details are available for one marketplace product on my Azure Stack activation?
      - Can I check a single syndicated Azure Stack marketplace item before downloading it?
      instructions:
      - text: Show marketplace product {productName} on Azure Stack activation {activationName}.
        slots:
          productName: path.productName
          activationName: path.activationName
      - text: Get details of syndicated marketplace item {productName}.
        slots:
          productName: path.productName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureBridge.Admin/activations/{activationName}/products/{productName}/download'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a marketplace product to Azure Stack
      effect: write
      questions:
      - How do I download an Azure Marketplace item onto my Azure Stack?
      - Can I pull a marketplace product down to Azure Stack through the bridge activation?
      instructions:
      - text: Download marketplace product {productName} to Azure Stack via activation {activationName}.
        slots:
          productName: path.productName
          activationName: path.activationName
      - text: Start downloading Azure Marketplace item {productName} to Azure Stack.
        slots:
          productName: path.productName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products'].get
  update:
    x-apievangelist-phrasing:
      intent: List products in an Azure Sphere catalog
      effect: read
      questions:
      - Which products are defined in my Azure Sphere catalog?
      - Can I enumerate every Sphere product in one catalog?
      instructions:
      - text: List products in Azure Sphere catalog {catalog}.
        slots:
          catalog: path.catalogName
      - text: Show all Sphere products under catalog {catalog}.
        slots:
          catalog: path.catalogName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Sphere product
      effect: read
      questions:
      - What are the details of one product in my Azure Sphere catalog?
      - Can I fetch a Sphere product by name?
      instructions:
      - text: Get Azure Sphere product {product} in catalog {catalog}.
        slots:
          product: path.productName
          catalog: path.catalogName
      - text: Show the description of Sphere product {product}.
        slots:
          product: path.productName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Azure Sphere product
      effect: write
      questions:
      - How do I create a new product in an Azure Sphere catalog?
      - Which product names are reserved in Azure Sphere?
      instructions:
      - text: Create Azure Sphere product {product} in catalog {catalog}.
        slots:
          product: path.productName
          catalog: path.catalogName
      - text: Create Sphere product {product} in {catalog} with properties {props}.
        slots:
          product: path.productName
          catalog: path.catalogName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure Sphere product
      effect: destructive
      questions:
      - Can I delete a product from my Azure Sphere catalog?
      - How can I remove a Sphere product I no longer ship?
      instructions:
      - text: Delete Azure Sphere product {product} from catalog {catalog}.
        slots:
          product: path.productName
          catalog: path.catalogName
      - text: Remove Sphere product {product} permanently.
        slots:
          product: path.productName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Azure Sphere product
      effect: write
      questions:
      - How do I change the description of an existing Azure Sphere product?
      - Can I patch a Sphere product's properties?
      instructions:
      - text: Update Azure Sphere product {product} in catalog {catalog}.
        slots:
          product: path.productName
          catalog: path.catalogName
      - text: Patch Sphere product {product} with properties {props}.
        slots:
          product: path.productName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/countDevices'].post
  update:
    x-apievangelist-phrasing:
      intent: Count devices in an Azure Sphere product
      effect: read
      questions:
      - How many devices belong to one Azure Sphere product across all its groups?
      - Can I get a quick device total for a Sphere product?
      instructions:
      - text: Count devices in Azure Sphere product {product} of catalog {catalog}.
        slots:
          product: path.productName
          catalog: path.catalogName
      - text: Tell me the total device count for product {product}.
        slots:
          product: path.productName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/generateDefaultDeviceGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate default device groups for a Sphere product
      effect: write
      questions:
      - How do I create the standard default device groups for an Azure Sphere product?
      - Can Azure Sphere auto-generate device groups for a new product?
      instructions:
      - text: Generate default device groups for Azure Sphere product {product} in catalog {catalog}.
        slots:
          product: path.productName
          catalog: path.catalogName
      - text: Set up the default groups for product {product}.
        slots:
          product: path.productName
      method: generated
      generated: '2026-09-26'