# 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 Edge Ordering Service-Partner Partner…
  version: 1.0.0
extends: openapi/microsoft-azure-partnerinventory-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EdgeOrderPartner/locations/{location}/productFamilies/{familyIdentifier}/inventories/{serialNumber}/manageInventoryMetadata'].post
  update:
    x-apievangelist-phrasing:
      intent: Update metadata on an Edge device inventory item
      effect: write
      questions:
      - How do I update the inventory metadata for an edge device I sell as a partner?
      - Can I push configuration settings onto an inventory device by its serial number?
      instructions:
      - text: Update inventory metadata for device {serialNumber} in product family {familyIdentifier} at {location} to {inventoryMetadata}.
        slots:
          serialNumber: path.serialNumber
          familyIdentifier: path.familyIdentifier
          location: path.location
          inventoryMetadata: requestBody.inventoryMetadata
      - text: Set on-device configuration {configurationOnDevice} for inventory serial {serialNumber}.
        slots:
          configurationOnDevice: requestBody.configurationOnDevice
          serialNumber: path.serialNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EdgeOrderPartner/locations/{location}/productFamilies/{familyIdentifier}/inventories/{serialNumber}/manageLink'].post
  update:
    x-apievangelist-phrasing:
      intent: Link or unlink a management resource to inventory
      effect: write
      questions:
      - How do I link a partner inventory device to its Azure management resource?
      - Can I unlink or relink a device from the management resource it's attached to?
      instructions:
      - text: Link device {serialNumber} in family {familyIdentifier} at {location} to management resource {managementResourceArmId}.
        slots:
          serialNumber: path.serialNumber
          familyIdentifier: path.familyIdentifier
          location: path.location
          managementResourceArmId: requestBody.managementResourceArmId
      - text: Run {operation} on the management link for inventory serial {serialNumber} in tenant {tenantId}.
        slots:
          operation: requestBody.operation
          serialNumber: path.serialNumber
          tenantId: requestBody.tenantId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EdgeOrderPartner/searchInventories'].post
  update:
    x-apievangelist-phrasing:
      intent: Search partner inventory by serial number
      effect: read
      questions:
      - How do I find an edge device in my partner inventory by its serial number?
      - Can I look up inventory for a specific product family and serial?
      instructions:
      - text: Search inventories for serial number {serialNumber} in family {familyIdentifier}.
        slots:
          serialNumber: requestBody.serialNumber
          familyIdentifier: requestBody.familyIdentifier
      - text: Find the partner inventory record for device {serialNumber} of family {familyIdentifier}.
        slots:
          serialNumber: requestBody.serialNumber
          familyIdentifier: requestBody.familyIdentifier
      method: generated
      generated: '2026-09-26'