Microsoft Azure API Management Tag API

The Tag API from Microsoft Azure API Management — 4 operation(s) for tag.

Operations 12

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}/tags List tags on the service · Microsoft Azure API Management Tag_ListByService #
Ask an LLM
“What tags are defined across my API Management service instance?”
“Can I see every service-level tag I use to organize APIs?”
Tell an agent
List all tags defined on my API Management service.
Show me every service-level tag.
HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId} Get a service tag's entity version · Microsoft Azure API Management Tag_GetEntityState #
Ask an LLM
“Can I check a service tag's entity version without fetching it?”
“Does a given tag exist on my service?”
Tell an agent
Check the entity state version of the service-level tag I name.
Confirm this tag exists on the service using only its version header.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId} Get a service-level tag · Microsoft Azure API Management Tag_Get #
Ask an LLM
“How do I look up one tag's display name on the service?”
“What does a particular service tag look like?”
Tell an agent
Get the service-level tag with the ID I give you.
Fetch this tag's details from the service.
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId} Create a service-level tag · Microsoft Azure API Management Tag_CreateOrUpdate #
Ask an LLM
“How do I create a new tag on my service for grouping APIs?”
“Can I define a tag at the service level rather than in a workspace?”
Tell an agent
Create a service-level tag with the ID I name.
Add a new tag to the API Management service.
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId} Rename a service-level tag · Microsoft Azure API Management Tag_Update #
Ask an LLM
“Can I change a service tag's display name without recreating it?”
“Is there a way to update an existing tag on the service?”
Tell an agent
Update the display name of the service-level tag I name.
Patch this existing service tag with new details.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId} Delete a service-level tag · Microsoft Azure API Management Tag_Delete #
Ask an LLM
“How can I remove a tag from my API Management service entirely?”
“Is deleting a service tag permanent?”
Tell an agent destructive · confirm first
Delete the service-level tag I name.
Remove this tag from the service altogether.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags List tags in a workspace · Microsoft Azure API Management WorkspaceTag_ListByService #
Ask an LLM
“Which tags are defined inside one of my workspaces?”
“Can I list only a single workspace's tags?”
Tell an agent
List every tag in the workspace I name.
Show me my workspace's tags.
HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId} Get a workspace tag's entity version · Microsoft Azure API Management WorkspaceTag_GetEntityState #
Ask an LLM
“Can I check a workspace tag's entity version without fetching it?”
“Does a given tag exist in my workspace?”
Tell an agent
Check the entity state version of the workspace tag I name.
Confirm this tag exists in my workspace from its version header.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId} Get a tag in a workspace · Microsoft Azure API Management WorkspaceTag_Get #
Ask an LLM
“How do I read one tag defined in a workspace?”
“What display name does a workspace tag have?”
Tell an agent
Get the workspace tag with the ID I give you.
Fetch one tag's details from inside my workspace.
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId} Create a tag in a workspace · Microsoft Azure API Management WorkspaceTag_CreateOrUpdate #
Ask an LLM
“How do I create a tag that belongs to a specific workspace?”
“Can I add tags scoped to a workspace rather than the whole service?”
Tell an agent
Create a tag inside the workspace I name.
Add a new workspace-scoped tag.
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId} Rename a tag in a workspace · Microsoft Azure API Management WorkspaceTag_Update #
Ask an LLM
“Can I change a workspace tag's display name in place?”
“Is it possible to update a tag scoped to a workspace?”
Tell an agent
Update the display name of the workspace tag I name.
Patch this tag inside my workspace.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId} Delete a tag in a workspace · Microsoft Azure API Management WorkspaceTag_Delete #
Ask an LLM
“How can I remove a tag from a workspace?”
“Is deleting a workspace tag reversible?”
Tell an agent destructive · confirm first
Delete the workspace tag I name.
Remove this tag from my workspace.

Documentation

Specifications

SDKs

Code Examples

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-chat-completion-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-chat-completion-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-completion-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-completion-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-embedding-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-embedding-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-mcp-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-mcp-response-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-chat-completion-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-chat-completion-response-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-completion-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-completion-response-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-embedding-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-embedding-response-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-mcp-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-mcp-response-structure.json

Other Resources

🔗
SDKs
https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-go/tree/main/sdk/resourcemanager/apimanagement
🔗
Tutorials
https://learn.microsoft.com/en-us/azure/api-management/transform-api
🔗
PolicySnippets
https://github.com/Azure/api-management-policy-snippets
🔗
Tools
https://github.com/Azure/azure-api-management-policy-toolkit
🔗
HelmChart
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
🔗
A2AAgentAPI
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
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-ld/microsoft-azure-api-management-ai-gateway-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-chat-completion-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-chat-completion-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-completion-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-completion-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-embedding-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-embedding-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-mcp-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-mcp-response-example.json
🔗
Tutorials
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-tag-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.

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

OpenAPI Specification

microsoft-azure-api-management-tag-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Azure API Management REST 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: Tag
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags
  : get:
      summary: Microsoft Azure API Management Tag_ListByService
      operationId: Tag_ListByService
      description: Lists a collection of tags defined within a service instance.
      responses:
        '200':
          description: Success
      tags:
      - Tag
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
  : head:
      summary: Microsoft Azure API Management Tag_GetEntityState
      operationId: Tag_GetEntityState
      description: Gets the entity state version of the tag specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    get:
      summary: Microsoft Azure API Management Tag_Get
      operationId: Tag_Get
      description: Gets the details of the tag specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    put:
      summary: Microsoft Azure API Management Tag_CreateOrUpdate
      operationId: Tag_CreateOrUpdate
      description: Creates a tag.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    patch:
      summary: Microsoft Azure API Management Tag_Update
      operationId: Tag_Update
      description: Updates the details of the tag specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    delete:
      summary: Microsoft Azure API Management Tag_Delete
      operationId: Tag_Delete
      description: Deletes specific tag of the API Management service instance.
      responses:
        '200':
          description: Success
      tags:
      - Tag
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags
  : get:
      summary: Microsoft Azure API Management WorkspaceTag_ListByService
      operationId: WorkspaceTag_ListByService
      description: Lists a collection of tags defined within a workspace in a service instance.
      responses:
        '200':
          description: Success
      tags:
      - Tag
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}
  : head:
      summary: Microsoft Azure API Management WorkspaceTag_GetEntityState
      operationId: WorkspaceTag_GetEntityState
      description: Gets the entity state version of the tag specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    get:
      summary: Microsoft Azure API Management WorkspaceTag_Get
      operationId: WorkspaceTag_Get
      description: Gets the details of the tag specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    put:
      summary: Microsoft Azure API Management WorkspaceTag_CreateOrUpdate
      operationId: WorkspaceTag_CreateOrUpdate
      description: Creates a tag.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    patch:
      summary: Microsoft Azure API Management WorkspaceTag_Update
      operationId: WorkspaceTag_Update
      description: Updates the details of the tag specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Tag
    delete:
      summary: Microsoft Azure API Management WorkspaceTag_Delete
      operationId: WorkspaceTag_Delete
      description: Deletes specific tag of the workspace in an API Management service instance.
      responses:
        '200':
          description: Success
      tags:
      - Tag
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/