Microsoft Azure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure CognitiveServicesManagementClient Cognitive…

10 actions 10 updates phrasing extends openapi/microsoft-azure-cognitiveservicesaccounts-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 10

$.info
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].put
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].delete
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts'].get
$.paths['/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/accounts'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/listKeys'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/regenerateKey'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/skus'].get

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 CognitiveServicesManagementClient Cognitive…
  version: 1.0.0
extends: openapi/microsoft-azure-cognitiveservicesaccounts-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Cognitive Services account
      effect: read
      questions:
      - What SKU, kind and endpoint does my Cognitive Services account have?
      - Can I look up one Cognitive Services account by name?
      instructions:
      - text: Get Cognitive Services account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the properties of Cognitive Services account {account} in {group}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Cognitive Services account
      effect: write
      questions:
      - How do I create a Cognitive Services account to get API keys?
      - What must I choose when creating an account — SKU, kind and location?
      instructions:
      - text: Create a {kind} Cognitive Services account {account} in {group} ({subscription}) with SKU {sku} in {location} and properties {properties}.
        slots:
          kind: requestBody.kind
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
          sku: requestBody.sku
          location: requestBody.location
          properties: requestBody.properties
      - text: Provision account {account} of kind {kind}, SKU {sku}, in {location} under group {group}, properties {properties}.
        slots:
          account: path.accountName
          kind: requestBody.kind
          sku: requestBody.sku
          location: requestBody.location
          group: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Cognitive Services account
      effect: destructive
      questions:
      - How can I delete a Cognitive Services account I no longer use?
      - Can I remove a Cognitive Services account from its resource group?
      instructions:
      - text: Delete Cognitive Services account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the Cognitive Services account {account} from {group}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a Cognitive Services account's SKU or tags
      effect: write
      questions:
      - Can I upgrade my Cognitive Services account to a different pricing tier?
      - What can I change on an existing account — just the SKU and tags?
      instructions:
      - text: Change the SKU of account {account} in {group} ({subscription}) to {sku}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
          sku: requestBody.sku
      - text: Set tags {tags} on Cognitive Services account {account} in {group}.
        slots:
          tags: requestBody.tags
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cognitive Services accounts in a group
      effect: read
      questions:
      - Which Cognitive Services accounts are in one resource group?
      - Can I narrow the account list to a single resource group?
      instructions:
      - text: List the Cognitive Services accounts in group {group}, subscription {subscription}.
        slots:
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show accounts that belong to resource group {group}.
        slots:
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cognitive Services accounts in a subscription
      effect: read
      questions:
      - What Cognitive Services accounts do I have across my entire subscription?
      - Can I list every AI services account in a subscription at once?
      instructions:
      - text: List all Cognitive Services accounts in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every account across all resource groups of {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the access keys of a Cognitive Services account
      effect: read
      questions:
      - Where do I find the API keys for my Cognitive Services account?
      - Can I read both access keys for an account programmatically?
      instructions:
      - text: List the keys for Cognitive Services account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Give me the access keys of {account} in {group}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/regenerateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a Cognitive Services account key
      effect: destructive
      questions:
      - How do I rotate a leaked Cognitive Services key?
      - Can I regenerate just Key1 or Key2 on an account?
      instructions:
      - text: Regenerate key {key_name} for account {account} in group {group}, subscription {subscription}.
        slots:
          key_name: requestBody.keyName
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Rotate the {key_name} access key of Cognitive Services account {account} in {group}.
        slots:
          key_name: requestBody.keyName
          account: path.accountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs available to a Cognitive Services account
      effect: read
      questions:
      - Which pricing tiers can my existing Cognitive Services account move to?
      - What SKUs are available for a specific account?
      instructions:
      - text: List available SKUs for account {account} in group {group}, subscription {subscription}.
        slots:
          account: path.accountName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the tiers Cognitive Services account {account} in {group} can use.
        slots:
          account: path.accountName
          group: path.resourceGroupName
      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-cognitiveservicesaccounts-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.