Microsoft Azure API Management

Microsoft Azure API Management is a hybrid, multicloud management platform for APIs across all environments. It is composed of an API gateway (data plane), a management plane, and a developer portal, and supports the complete API lifecycle for publishing, securing, monitoring, and transforming APIs for external, partner, and internal developers. It now includes an AI gateway for governing OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, Microsoft Foundry models, Amazon Bedrock, MCP servers exposed from REST APIs or proxied from external MCP backends, and A2A agent APIs - with token rate limiting, semantic caching, content safety, backend load balancing, circuit breakers, and token emission to Application Insights. It pairs with Azure API Center for design-time inventory, governance, and discovery.

6 APIs 0 Features

A2AAI GatewayAPI CenterAPI GatewayAPI ManagementEnterpriseMCPMicrosoft Azure

APIs

Azure API Management REST API

The Azure API Management REST API provides programmatic access to manage API Management service instances and their entities, including APIs, products, subscriptions, users, gro...

Azure API Management Gateway

The Azure API Management gateway (data plane) acts as a facade to backend services, routing API requests, enforcing policies, verifying credentials, applying rate limits and quo...

Azure API Management Self-Hosted Gateway

The Azure API Management self-hosted gateway is a containerized, Linux-based Docker image that can be deployed to Kubernetes, Docker, or any container orchestration platform in ...

Azure API Management AI Gateway

The Azure API Management AI gateway extends the existing API gateway with capabilities to manage, secure, scale, monitor, and govern AI backends. Supported AI API schemas includ...

Azure API Center

Azure API Center is the design-time governance and centralized discovery counterpart to Azure API Management. It enables organizations to track all of their APIs - regardless of...

Azure API Management Developer Portal

The Azure API Management developer portal is an automatically generated, fully customizable website that allows API consumers to discover APIs, read documentation, test APIs thr...

Collections

Azure API Management AI Gateway

POSTMAN

Azure API Management Developer Portal

POSTMAN

Azure API Management Gateway

POSTMAN

Azure API Management REST API

POSTMAN

Azure API Management Self-Hosted Gateway

POSTMAN

Arazzo Workflows

Azure API Management AI Gateway Chat and Embed

Send a chat completion through the AI gateway, then embed the same prompt for retrieval.

ARAZZO

Azure API Management Apply API Policy

Confirm an API exists, set its policy document, then read the policy back.

ARAZZO

Azure API Management Backup Service

Confirm the service exists, trigger a backup to storage, then re-read the service state.

ARAZZO

Azure API Management Configure API Diagnostic

Confirm an API exists, attach an Application Insights diagnostic, then read it back.

ARAZZO

Azure API Management Configure GraphQL Resolver

Confirm a GraphQL API exists, attach a resolver, then list the API's resolvers.

ARAZZO

Azure API Management Configure Logger and Service Diagnostic

Create a logger, attach a service-wide diagnostic to it, then read the diagnostic back.

ARAZZO

Azure API Management Configure Product Policy

Confirm a product exists, set its policy document, then read the policy back.

ARAZZO

Azure API Management Define API Operation

Confirm an API exists, add an operation to it, then list the API's operations.

ARAZZO

Azure API Management Developer Portal Discover and Invoke

Browse the developer portal APIs, read one API's details, then call it through the gateway.

ARAZZO

Azure API Management Link Product to Group

Confirm a product and a group exist, then grant the group access to the product.

ARAZZO

Azure API Management Manage Workspace Named Value

Create a workspace named value, read it back, then list the workspace named values.

ARAZZO

Azure API Management Onboard User to Group

Create a user, confirm a group exists, add the user to the group, then list members.

ARAZZO

Azure API Management Provision Backend

Register a backend, read it back, then trigger a reconnect.

ARAZZO

Azure API Management Provision Certificate for Backend

Upload a certificate, create a backend that uses it for mutual TLS, then read the backend.

ARAZZO

Azure API Management Provision Product and Link API

Create a product, link an API to it, then list the product's APIs.

ARAZZO

Azure API Management Provision Service

Check a service name, create the API Management service, then poll until provisioning succeeds.

ARAZZO

Azure API Management Provision Subscription and Retrieve Keys

Confirm a product, create a subscription against it, then retrieve the subscription keys.

ARAZZO

Azure API Management Provision Workspace API

Create a workspace, register an API inside it, then read the workspace API back.

ARAZZO

Azure API Management Provision Workspace Product and Subscription

Create a workspace product, create a subscription scoped to it, then read the subscription.

ARAZZO

Azure API Management Publish API Release

Confirm an API exists, create a release for it, then list its releases.

ARAZZO

Azure API Management Register API Schema

Confirm an API exists, register a schema for it, then list the API's schemas.

ARAZZO

Azure API Management Register Gateway and Link API

Register a self-hosted gateway, link an API to it, then generate a gateway token.

ARAZZO

Azure API Management Rotate Subscription Keys

Confirm a subscription, regenerate both keys, then retrieve the new secrets.

ARAZZO

Azure API Management Set Global Service Policy

Confirm the service exists, set the global policy, then read the policy back.

ARAZZO

Azure API Management Tag and Label an API

Create a tag, assign it to an API, then list the API's tags.

ARAZZO

Azure API Management Tag a Product

Create a tag, assign it to a product, then list the product's tags.

ARAZZO

Azure API Management Upsert API

Find an API by identifier and update it if present, otherwise create it.

ARAZZO

Azure API Management Upsert Product

Find a product by identifier and update it if present, otherwise create it.

ARAZZO

Azure API Management Upsert User

Find a user by identifier and update it if present, otherwise create it.

ARAZZO

GraphQL

Microsoft Azure API Management GraphQL API

GRAPHQL

Pricing Plans

Microsoft Azure Api Management Plans Pricing

8 plans

PLANS

Rate Limits

Microsoft Azure Api Management Rate Limits

4 limits

RATE LIMITS

FinOps

Microsoft Azure Api Management Finops

FINOPS

Semantic Vocabularies

Microsoft Azure Api Management Ai Gateway Context

0 classes · 8 properties

JSON-LD

API Governance Rules

Microsoft Azure API Management API Rules

15 rules · 1 errors 6 warnings 8 info

SPECTRAL

JSON Structure

Ai Gateway Chat Completion Request Structure

3 properties

JSON STRUCTURE

Ai Gateway Chat Completion Response Structure

6 properties

JSON STRUCTURE

Ai Gateway Completion Request Structure

3 properties

JSON STRUCTURE

Ai Gateway Completion Response Structure

6 properties

JSON STRUCTURE

Ai Gateway Embedding Request Structure

2 properties

JSON STRUCTURE

Ai Gateway Embedding Response Structure

4 properties

JSON STRUCTURE

Ai Gateway Mcp Request Structure

4 properties

JSON STRUCTURE

Ai Gateway Mcp Response Structure

3 properties

JSON STRUCTURE

Microsoft Azure Api Management Structure

0 properties

JSON STRUCTURE

Example Payloads

Ai Gateway Chat Completion Request Example

3 fields

EXAMPLE

Ai Gateway Chat Completion Response Example

6 fields

EXAMPLE

Ai Gateway Completion Request Example

3 fields

EXAMPLE

Ai Gateway Completion Response Example

6 fields

EXAMPLE

Ai Gateway Embedding Request Example

2 fields

EXAMPLE

Ai Gateway Embedding Response Example

4 fields

EXAMPLE

Ai Gateway Mcp Request Example

4 fields

EXAMPLE

Ai Gateway Mcp Response Example

3 fields

EXAMPLE

Microsoft Azure Api Management Aigateway Chatcompletions Example

6 fields

EXAMPLE

Microsoft Azure Api Management Aigateway Completions Example

6 fields

EXAMPLE

Microsoft Azure Api Management Aigateway Embeddings Example

6 fields

EXAMPLE

Microsoft Azure Api Management Aigateway Mcp Example

6 fields

EXAMPLE

Microsoft Azure Api Management Api Createorupdate Example

6 fields

EXAMPLE

Microsoft Azure Api Management Api Get Example

6 fields

EXAMPLE

Microsoft Azure Api Management Api Listbyservice Example

6 fields

EXAMPLE

Microsoft Azure Api Management Api Update Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apidiagnostic Createorupdate Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apidiagnostic Get Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apidiagnostic Listbyservice Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementoperations List Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementservice Checknameavailability Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementservice Createorupdate Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementservice Get Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementservice Getdomainownershipidentifier Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementservice List Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementservice Listbyresourcegroup Example

6 fields

EXAMPLE

Microsoft Azure Api Management Apimanagementservice Update Example

6 fields

EXAMPLE

Microsoft Azure Api Management Devportal Getapi Example

6 fields

EXAMPLE

Microsoft Azure Api Management Devportal Home Example

6 fields

EXAMPLE

Microsoft Azure Api Management Devportal Listapis Example

6 fields

EXAMPLE

Microsoft Azure Api Management Devportal Listproducts Example

6 fields

EXAMPLE

Microsoft Azure Api Management Devportal Profile Example

6 fields

EXAMPLE

Microsoft Azure Api Management Devportal Signin Example

6 fields

EXAMPLE

Microsoft Azure Api Management Devportal Signup Example

6 fields

EXAMPLE

Microsoft Azure Api Management Gateway Healthcheck Example

6 fields

EXAMPLE

Microsoft Azure Api Management Gateway Proxydelete Example

6 fields

EXAMPLE

Microsoft Azure Api Management Gateway Proxyget Example

6 fields

EXAMPLE

Microsoft Azure Api Management Gateway Proxypost Example

6 fields

EXAMPLE

Microsoft Azure Api Management Gateway Proxyput Example

6 fields

EXAMPLE

Microsoft Azure Api Management Selfhostedgateway Healthcheck Example

6 fields

EXAMPLE

Microsoft Azure Api Management Selfhostedgateway Internalstatus Example

6 fields

EXAMPLE

Microsoft Azure Api Management Selfhostedgateway Proxyget Example

6 fields

EXAMPLE

Microsoft Azure Api Management Selfhostedgateway Proxypost Example

6 fields

EXAMPLE

Resources

PostmanWorkspace

PostmanWorkspace

Documentation

GettingStarted

GettingStarted

APIReference

Authentication

BestPractices

GitHubRepository

GitHubRepository

GitHubOrganization

GitHubOrganization

TermsOfService

PrivacyPolicy

TrustCenter

DeveloperPortal

DeveloperPortal

CodeExamples

PolicySnippets

BreakingChanges

BreakingChanges

FoundryIntegration

FoundryIntegration

AIGatewaySamples

AIGatewaySamples

AIGatewayWorkshop

AIGatewayWorkshop

VSCodeExtension

VSCodeExtension

SpectralRules

Sources

info:
  _postman_id: b9e3b9b3-911e-41ed-9dd0-4984f7848902
  name: Azure API Management Self-Hosted Gateway
  description: "The self-hosted gateway is a containerized version of the Azure API Management gateway that can be deployed\
    \ on-premises, in other clouds, or on Kubernetes. It connects to a cloud-based API Management instance for configuration\
    \ and reports telemetry back.\n\nContact Support:\n Name: Microsoft Azure"
  schema: https://schema.getpostman.com/json/collection/v2.1.0/collection.json
  createdAt: '2026-06-05T15:01:36.000Z'
  updatedAt: '2026-06-05T15:01:36.000Z'
  lastUpdatedBy: '35240'
  uid: 35240-b9e3b9b3-911e-41ed-9dd0-4984f7848902
item:
- name: '{api-path}'
  item:
  - name: Proxy GET request through self-hosted gateway
    id: 2eba8ca0-0020-4ad9-8cd5-33557f73edb6
    protocolProfileBehavior:
      disableBodyPruning: true
    request:
      method: GET
      header:
      - key: Accept
        value: application/json
      url:
        raw: '{{baseUrl}}/:api-path'
        host:
        - '{{baseUrl}}'
        path:
        - :api-path
        variable:
        - id: c519c3f3-845e-4155-96aa-94904969190a
          key: api-path
          value: <string>
          description: '(Required) '
      description: Routes GET request through the self-hosted gateway.
    response:
    - id: 89623972-fb41-4688-ab1f-27a5e506d7ed
      name: Response from backend API
      originalRequest:
        method: GET
        header:
        - key: Accept
          value: application/json
        url:
          raw: '{{baseUrl}}/:api-path'
          host:
          - '{{baseUrl}}'
          path:
          - :api-path
          variable:
          - key: api-path
      status: OK
      code: 200
      _postman_previewlanguage: json
      header:
      - key: Content-Type
        value: application/json
      cookie: []
      responseTime: null
      body: "{\n  \"statusCode\": \"<integer>\",\n  \"headers\": {\n    \"x-apim-request-id\": \"<string>\"\n  },\n  \"body\"\
        : {}\n}"
      createdAt: '2026-06-05T15:01:37.000Z'
      updatedAt: '2026-06-05T15:01:37.000Z'
      uid: 35240-89623972-fb41-4688-ab1f-27a5e506d7ed
    createdAt: '2026-06-05T15:01:37.000Z'
    updatedAt: '2026-06-05T15:01:37.000Z'
    uid: 35240-2eba8ca0-0020-4ad9-8cd5-33557f73edb6
  - name: Proxy POST request through self-hosted gateway
    id: 981422c9-4b2b-4ea0-8caf-70458084a913
    protocolProfileBehavior:
      disableBodyPruning: true
    request:
      method: POST
      header:
      - key: Content-Type
        value: application/json
      - key: Accept
        value: application/json
      body:
        mode: raw
        raw: '{}'
        options:
          raw:
            headerFamily: json
            language: json
      url:
        raw: '{{baseUrl}}/:api-path'
        host:
        - '{{baseUrl}}'
        path:
        - :api-path
        variable:
        - id: d055fc75-23a1-40af-846a-463b86259e5b
          key: api-path
          value: <string>
          description: '(Required) '
      description: Routes POST request through the self-hosted gateway.
    response:
    - id: 21d3880c-21fb-41c0-bf76-ac4ff9aefd08
      name: Response from backend API
      originalRequest:
        method: POST
        header:
        - key: Content-Type
          value: application/json
        - key: Accept
          value: application/json
        body:
          mode: raw
          raw: '{}'
          options:
            raw:
              headerFamily: json
              language: json
        url:
          raw: '{{baseUrl}}/:api-path'
          host:
          - '{{baseUrl}}'
          path:
          - :api-path
          variable:
          - key: api-path
      status: OK
      code: 200
      _postman_previewlanguage: json
      header:
      - key: Content-Type
        value: application/json
      cookie: []
      responseTime: null
      body: "{\n  \"statusCode\": \"<integer>\",\n  \"headers\": {\n    \"x-apim-request-id\": \"<string>\"\n  },\n  \"body\"\
        : {}\n}"
      createdAt: '2026-06-05T15:01:37.000Z'
      updatedAt: '2026-06-05T15:01:37.000Z'
      uid: 35240-21d3880c-21fb-41c0-bf76-ac4ff9aefd08
    createdAt: '2026-06-05T15:01:37.000Z'
    updatedAt: '2026-06-05T15:01:37.000Z'
    uid: 35240-981422c9-4b2b-4ea0-8caf-70458084a913
  id: 7f88a4a1-df30-43a7-86cc-805d4563fb28
  createdAt: '2026-06-05T15:01:37.000Z'
  updatedAt: '2026-06-05T15:01:37.000Z'
  uid: 35240-7f88a4a1-df30-43a7-86cc-805d4563fb28
- name: status-0123456789abcdef
  item:
  - name: Self-hosted gateway health check
    id: 16363981-4b35-48ca-a59c-6b17f83e1b59
    protocolProfileBehavior:
      disableBodyPruning: true
    request:
      method: GET
      header:
      - key: Accept
        value: application/json
      url:
        raw: '{{baseUrl}}/status-0123456789abcdef'
        host:
        - '{{baseUrl}}'
        path:
        - status-0123456789abcdef
      description: Returns the health status of the self-hosted gateway container.
    response:
    - id: 55d50ac0-b193-4085-8723-de6e644a9d31
      name: Gateway is healthy
      originalRequest:
        method: GET
        header:
        - key: Accept
          value: application/json
        url:
          raw: '{{baseUrl}}/status-0123456789abcdef'
          host:
          - '{{baseUrl}}'
          path:
          - status-0123456789abcdef
      status: OK
      code: 200
      _postman_previewlanguage: json
      header:
      - key: Content-Type
        value: application/json
      cookie: []
      responseTime: null
      body: "{\n  \"status\": \"<string>\",\n  \"timestamp\": \"<dateTime>\"\n}"
      createdAt: '2026-06-05T15:01:37.000Z'
      updatedAt: '2026-06-05T15:01:37.000Z'
      uid: 35240-55d50ac0-b193-4085-8723-de6e644a9d31
    createdAt: '2026-06-05T15:01:37.000Z'
    updatedAt: '2026-06-05T15:01:37.000Z'
    uid: 35240-16363981-4b35-48ca-a59c-6b17f83e1b59
  id: d0051c0d-936f-45ed-ae88-e2f1d9a10dc1
  createdAt: '2026-06-05T15:01:37.000Z'
  updatedAt: '2026-06-05T15:01:37.000Z'
  uid: 35240-d0051c0d-936f-45ed-ae88-e2f1d9a10dc1
- name: internal
  item:
  - name: status
    item:
    - name: Internal status endpoint
      id: b7464f42-b021-41a2-9f39-c0de80afd599
      protocolProfileBehavior:
        disableBodyPruning: true
      request:
        method: GET
        header:
        - key: Accept
          value: application/json
        url:
          raw: '{{baseUrl}}/internal/status'
          host:
          - '{{baseUrl}}'
          path:
          - internal
          - status
        description: Returns detailed internal status of the self-hosted gateway container.
      response:
      - id: 646fb591-40f6-445e-855f-cc741b8382d2
        name: Internal status details
        originalRequest:
          method: GET
          header:
          - key: Accept
            value: application/json
          url:
            raw: '{{baseUrl}}/internal/status'
            host:
            - '{{baseUrl}}'
            path:
            - internal
            - status
        status: OK
        code: 200
        _postman_previewlanguage: json
        header:
        - key: Content-Type
          value: application/json
        cookie: []
        responseTime: null
        body: "{\n  \"status\": \"<string>\",\n  \"version\": \"<string>\",\n  \"configurationStatus\": \"<string>\",\n  \"\
          lastConfigurationUpdate\": \"<dateTime>\",\n  \"connectedToManagementPlane\": \"<boolean>\",\n  \"uptimeSeconds\"\
          : \"<integer>\"\n}"
        createdAt: '2026-06-05T15:01:37.000Z'
        updatedAt: '2026-06-05T15:01:37.000Z'
        uid: 35240-646fb591-40f6-445e-855f-cc741b8382d2
      createdAt: '2026-06-05T15:01:37.000Z'
      updatedAt: '2026-06-05T15:01:37.000Z'
      uid: 35240-b7464f42-b021-41a2-9f39-c0de80afd599
    id: 691e272a-cfde-40e1-9b66-834667750dd0
    createdAt: '2026-06-05T15:01:37.000Z'
    updatedAt: '2026-06-05T15:01:37.000Z'
    uid: 35240-691e272a-cfde-40e1-9b66-834667750dd0
  id: 38d875df-e602-40ce-b11b-9ab1fadb1f55
  createdAt: '2026-06-05T15:01:37.000Z'
  updatedAt: '2026-06-05T15:01:37.000Z'
  uid: 35240-38d875df-e602-40ce-b11b-9ab1fadb1f55
variable:
- key: gateway-hostname
  value: apim-gateway.contoso.com
- key: baseUrl
  value: https://{{gateway-hostname}}