Microsoft Azure API Management

Microsoft Azure API Management ApiTag API

The ApiTag API from Microsoft Azure API Management — 2 operation(s) for apitag.

Documentation GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags List tags on an API · Microsoft Azure API Management Tag_ListByApi #

Ask an LLM

“Which tags are attached to one of my APIs?”

“Can I see how a single API is tagged in API Management?”

Tell an agent

List every tag attached to API {apiId} in service {serviceName}.

Show me this API's tags.

HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId} Check a tag's version on an API · Microsoft Azure API Management Tag_GetEntityStateByApi #

Ask an LLM

“Can I confirm a tag is attached to an API using only a header check?”

“What entity version does the tag on my API have?”

Tell an agent

Check the entity state of tag {tagId} on API {apiId} in service {serviceName}.

Confirm this API carries the tag from its version header.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId} Get a tag attached to an API · Microsoft Azure API Management Tag_GetByApi #

Ask an LLM

“How do I check whether a specific tag is applied to an API and see its details?”

“What display name does a tag on my API have?”

Tell an agent

Get tag {tagId} as it is attached to API {apiId} in service {serviceName}.

Show me one tag assigned to the API.

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId} Tag an API · Microsoft Azure API Management Tag_AssignToApi #

Ask an LLM

“How do I attach an existing tag to an API?”

“Can I assign a service tag to one API so it groups with others?”

Tell an agent

Assign tag {tagId} to API {apiId} in service {serviceName}.

Attach an existing tag to the API.

DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId} Remove a tag from an API · Microsoft Azure API Management Tag_DetachFromApi #

Ask an LLM

“How can I untag an API without deleting the tag itself?”

“Does detaching a tag from an API remove the tag from the service?”

Tell an agent destructive · confirm first

Detach tag {tagId} from API {apiId} in service {serviceName}.

Untag the API, leaving the tag defined on the service.

Documentation

https://learn.microsoft.com/en-us/rest/api/apimanagement/

https://learn.microsoft.com/en-us/rest/api/apimanagement/operation-groups

https://learn.microsoft.com/en-us/azure/api-management/authentication-authorization-overview

https://learn.microsoft.com/en-us/azure/api-management/api-management-key-concepts

https://learn.microsoft.com/en-us/azure/api-management/api-management-policies

https://learn.microsoft.com/en-us/azure/api-management/import-and-publish

https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-overview

https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-azure-kubernetes-service

https://learn.microsoft.com/en-us/azure/api-management/genai-gateway-capabilities

https://learn.microsoft.com/en-us/azure/api-management/azure-openai-api-from-specification

https://learn.microsoft.com/en-us/azure/api-management/azure-ai-foundry-api

https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-developer-portal-customize

Specifications

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/openapi/microsoft-azure-api-management-apitag-api-openapi.yml

SDKs

GitHubRepository

https://github.com/Azure/api-management-self-hosted-gateway

GitHubRepository

https://github.com/Azure/api-management-developer-portal

Code Examples

https://github.com/Azure/api-management-self-hosted-gateway-ingress

https://github.com/Azure-Samples/ai-gateway

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-chat-completion-request-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-chat-completion-response-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-completion-request-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-completion-response-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-embedding-request-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-embedding-response-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-mcp-request-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-mcp-response-schema.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-chat-completion-request-structure.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-chat-completion-response-structure.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-completion-request-structure.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-completion-response-structure.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-embedding-request-structure.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-embedding-response-structure.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-mcp-request-structure.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-mcp-response-structure.json

Other Resources

https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/apimanagement

https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/apimanagement

https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/apimanagement

https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/apimanagement

https://github.com/Azure/azure-sdk-for-go/tree/main/sdk/resourcemanager/apimanagement

https://learn.microsoft.com/en-us/azure/api-management/transform-api

https://github.com/Azure/api-management-policy-snippets

https://github.com/Azure/azure-api-management-policy-toolkit

https://github.com/Azure/api-management-self-hosted-gateway/tree/main/helm-charts/azure-api-management-gateway

MCPServerOverview

https://learn.microsoft.com/en-us/azure/api-management/mcp-server-overview

ExportRESTToMCP

https://learn.microsoft.com/en-us/azure/api-management/export-rest-mcp-server

ProxyExistingMCP

https://learn.microsoft.com/en-us/azure/api-management/expose-existing-mcp-server

https://learn.microsoft.com/en-us/azure/api-management/agent-to-agent-api

TokenLimitPolicy

https://learn.microsoft.com/en-us/azure/api-management/llm-token-limit-policy

SemanticCaching

https://learn.microsoft.com/en-us/azure/api-management/azure-openai-enable-semantic-caching

ContentSafetyPolicy

https://learn.microsoft.com/en-us/azure/api-management/llm-content-safety-policy

ReferenceArchitecture

https://github.com/Azure-Samples/ai-hub-gateway-solution-accelerator

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-ld/microsoft-azure-api-management-ai-gateway-context.jsonld

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-chat-completion-request-example.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-chat-completion-response-example.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-completion-request-example.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-completion-response-example.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-embedding-request-example.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-embedding-response-example.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-mcp-request-example.json

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-mcp-response-example.json

https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-developer-portal-customize

Work with this as data

Every API 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 apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
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 API

curl "https://apis.io/api/v1/apis/microsoft-azure-api-management-apitag-api"

All apis

curl "https://apis.io/api/v1/apis?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.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Azure API Management REST API Tag API
  description: REST APIs for managing Azure API Management service instances and their entities including APIs, products, subscriptions, users, groups, policies, gateways, backends, certificates, and workspaces. Uses Azure Resource Manager conventions.
  version: '2024-05-01'
  contact:
    name: Microsoft Azure
    url: https://learn.microsoft.com/en-us/rest/api/apimanagement/
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-source: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/apimanagement/resource-manager/Microsoft.ApiManagement/ApiManagement/stable/2024-05-01
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: ApiTag
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags
  : get:
      summary: Microsoft Azure API Management Tag_ListByApi
      operationId: Tag_ListByApi
      description: Lists all Tags associated with the API.
      responses:
        '200':
          description: Success
      tags:
      - ApiTag
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
  : head:
      summary: Microsoft Azure API Management Tag_GetEntityStateByApi
      operationId: Tag_GetEntityStateByApi
      description: Gets the entity state version of the tag specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - ApiTag
    get:
      summary: Microsoft Azure API Management Tag_GetByApi
      operationId: Tag_GetByApi
      description: Get tag associated with the API.
      responses:
        '200':
          description: Success
      tags:
      - ApiTag
    put:
      summary: Microsoft Azure API Management Tag_AssignToApi
      operationId: Tag_AssignToApi
      description: Assign tag to the Api.
      responses:
        '200':
          description: Success
      tags:
      - ApiTag
    delete:
      summary: Microsoft Azure API Management Tag_DetachFromApi
      operationId: Tag_DetachFromApi
      description: Detach the tag from the Api.
      responses:
        '200':
          description: Success
      tags:
      - ApiTag
components:
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
          scopes:
            user_impersonation: impersonate your user account
externalDocs:
  description: Azure API Management REST API Reference
  url: https://learn.microsoft.com/en-us/rest/api/apimanagement/