Microsoft Azure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure Products API

11 actions 11 updates phrasing extends openapi/microsoft-azure-products-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 11

$.info

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureBridge.Admin/activations/{activationName}/products'].get

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureBridge.Admin/activations/{activationName}/products/{productName}'].get

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureBridge.Admin/activations/{activationName}/products/{productName}/download'].post

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products'].get

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].get

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].put

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].delete

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}'].patch

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/countDevices'].post

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/generateDefaultDeviceGroups'].post

OpenAPI Overlay

Raw ↑

# 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'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/microsoft-azure-products-api-phrasing-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.