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:microsoft-azure-api-management-group-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: 3.2.0
info:
title: Microsoft Azure Api Management Group API
version: '2024-05-01'
description: 'Operations tagged Group across 2 of this provider''s published API definitions: microsoft-azure-api-management-apimanagement-resource-manager-Microsoft.ApiManagement-ApiManagement-stable-2024-05-01-apimgroups.json, microsoft-azure-api-management-apimanagement-resource-manager-Microsoft.ApiManagement-ApiManagement-stable-2024-05-01-apimworkspaces.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://management.azure.com
security:
- azure_auth:
- user_impersonation
tags:
- name: Group
paths:
? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups
: get:
tags:
- Group
operationId: Group_ListByService
description: Lists a collection of groups defined within a service instance.
externalDocs:
url: https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-create-groups
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- name: $filter
in: query
required: false
description: '| Field | Usage | Supported operators | Supported functions |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| externalId | filter | eq | |</br>'
schema:
type: string
- $ref: '#/components/parameters/TopQueryParameter'
- $ref: '#/components/parameters/SkipQueryParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: Lists a collection of Group entities.
content:
application/json:
schema:
$ref: '#/components/schemas/GroupCollection'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-ms-pageable:
nextLinkName: nextLink
x-ms-odata: ./definitions.json#/definitions/GroupContract
summary: Group list by service
x-summary-source: derived
servers:
- url: https://management.azure.com
? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
: head:
tags:
- Group
operationId: Group_GetEntityTag
description: Gets the entity state (Etag) version of the group specified by its identifier.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: Specified group entity exists and current entity state version is present in the ETag header.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
summary: Group get entity tag
x-summary-source: derived
get:
tags:
- Group
operationId: Group_Get
description: Gets the details of the group specified by its identifier.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: The response body contains the specified Group entity.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
summary: Group get
x-summary-source: derived
put:
tags:
- Group
operationId: Group_CreateOrUpdate
description: Creates or Updates a group.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/IfMatchOptionalParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'201':
description: Group was created successfully.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
'200':
description: Group already exists.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GroupCreateParameters'
description: Create parameters.
required: true
summary: Group create or update
x-summary-source: derived
patch:
tags:
- Group
operationId: Group_Update
description: Updates the details of the group specified by its identifier.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/IfMatchRequiredParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: The group details were successfully updated.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GroupUpdateParameters'
description: Update parameters.
required: true
summary: Group update
x-summary-source: derived
delete:
tags:
- Group
operationId: Group_Delete
description: Deletes specific group of the API Management service instance.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/IfMatchRequiredParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: The group was successfully deleted.
'204':
description: The group was successfully deleted.
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
summary: Group delete
x-summary-source: derived
servers:
- url: https://management.azure.com
? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/groups
: get:
tags:
- Group
operationId: WorkspaceGroup_ListByService
description: Lists a collection of groups defined within a workspace in a service instance.
externalDocs:
url: https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-create-groups
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/WorkspaceIdParameter'
- name: $filter
in: query
required: false
description: '| Field | Usage | Supported operators | Supported functions |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| externalId | filter | eq | |</br>'
schema:
type: string
- $ref: '#/components/parameters/TopQueryParameter'
- $ref: '#/components/parameters/SkipQueryParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: Lists a collection of Group entities.
content:
application/json:
schema:
$ref: '#/components/schemas/GroupCollection'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-ms-pageable:
nextLinkName: nextLink
x-ms-odata: ./definitions.json#/definitions/GroupContract
summary: Workspace group list by service
x-summary-source: derived
servers:
- url: https://management.azure.com
? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/groups/{groupId}
: head:
tags:
- Group
operationId: WorkspaceGroup_GetEntityTag
description: Gets the entity state (Etag) version of the group specified by its identifier.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/WorkspaceIdParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: Specified group entity exists and current entity state version is present in the ETag header.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
summary: Workspace group get entity tag
x-summary-source: derived
get:
tags:
- Group
operationId: WorkspaceGroup_Get
description: Gets the details of the group specified by its identifier.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/WorkspaceIdParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: The response body contains the specified Group entity.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
summary: Workspace group get
x-summary-source: derived
put:
tags:
- Group
operationId: WorkspaceGroup_CreateOrUpdate
description: Creates or Updates a group.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/WorkspaceIdParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/IfMatchOptionalParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'201':
description: Group was created successfully.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
'200':
description: Group already exists.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GroupCreateParameters'
description: Create parameters.
required: true
summary: Workspace group create or update
x-summary-source: derived
patch:
tags:
- Group
operationId: WorkspaceGroup_Update
description: Updates the details of the group specified by its identifier.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/WorkspaceIdParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/IfMatchRequiredParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: The group details were successfully updated.
headers:
ETag:
description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GroupContract'
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GroupUpdateParameters'
description: Update parameters.
required: true
summary: Workspace group update
x-summary-source: derived
delete:
tags:
- Group
operationId: WorkspaceGroup_Delete
description: Deletes specific group of the workspace in an API Management service instance.
parameters:
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/ServiceNameParameter'
- $ref: '#/components/parameters/WorkspaceIdParameter'
- $ref: '#/components/parameters/GroupIdParameter'
- $ref: '#/components/parameters/IfMatchRequiredParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- $ref: '#/components/parameters/SubscriptionIdParameter'
responses:
'200':
description: The group was successfully deleted.
'204':
description: The group was successfully deleted.
default:
description: Error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
summary: Workspace group delete
x-summary-source: derived
servers:
- url: https://management.azure.com
components:
schemas:
GroupCreateParameters:
type: object
properties:
properties:
x-ms-client-flatten: true
$ref: '#/components/schemas/GroupCreateParametersProperties'
description: Properties supplied to Create Group operation.
description: Parameters supplied to the Create Group operation.
GroupCollection:
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/GroupContract'
description: Page values.
count:
type: integer
format: int64
description: Total record count number across all pages.
nextLink:
type: string
description: Next page link if any.
description: Paged Group list representation.
GroupContract:
type: object
properties:
properties:
x-ms-client-flatten: true
$ref: '#/components/schemas/GroupContractProperties'
description: Group entity contract properties.
allOf:
- $ref: '#/components/schemas/ProxyResource'
description: Contract details.
ErrorResponse:
type: object
title: Error response
description: Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
properties:
error:
$ref: '#/components/schemas/ErrorDetail'
description: The error object.
GroupUpdateParameters:
type: object
properties:
properties:
x-ms-client-flatten: true
$ref: '#/components/schemas/GroupUpdateParametersProperties'
description: Group entity update contract properties.
description: Parameters supplied to the Update Group operation.
ProxyResource:
title: Proxy Resource
description: The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location
type: object
allOf:
- $ref: '#/components/schemas/Resource'
parameters:
SubscriptionIdParameter:
name: subscriptionId
in: path
description: The ID of the target subscription. The value must be an UUID.
required: true
schema:
type: string
format: uuid
TopQueryParameter:
name: $top
in: query
required: false
description: Number of records to return.
x-ms-parameter-location: method
schema:
type: integer
format: int32
minimum: 1
SkipQueryParameter:
name: $skip
in: query
required: false
description: Number of records to skip.
x-ms-parameter-location: method
schema:
type: integer
format: int32
minimum: 0
ServiceNameParameter:
name: serviceName
in: path
required: true
description: The name of the API Management service.
x-ms-parameter-location: method
schema:
type: string
maxLength: 50
minLength: 1
pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$
ApiVersionParameter:
name: api-version
in: query
description: The API version to use for this operation.
required: true
schema:
type: string
minLength: 1
IfMatchRequiredParameter:
name: If-Match
in: header
required: true
description: ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update.
x-ms-parameter-location: method
schema:
type: string
GroupIdParameter:
name: groupId
in: path
required: true
description: Group identifier. Must be unique in the current API Management service instance.
x-ms-parameter-location: method
schema:
type: string
maxLength: 256
minLength: 1
ResourceGroupNameParameter:
name: resourceGroupName
in: path
description: The name of the resource group. The name is case insensitive.
required: true
x-ms-parameter-location: method
schema:
type: string
maxLength: 90
minLength: 1
IfMatchOptionalParameter:
name: If-Match
in: header
required: false
description: ETag of the Entity. Not required when creating an entity, but required when updating an entity.
x-ms-parameter-location: method
schema:
type: string
WorkspaceIdParameter:
name: workspaceId
in: path
required: true
description: Workspace identifier. Must be unique in the current API Management service instance.
x-ms-parameter-location: method
schema:
type: string
maxLength: 80
minLength: 1
pattern: ^[^*#&+:<>?]+$
securitySchemes:
azure_auth:
type: oauth2
flows:
implicit:
scopes:
user_impersonation: impersonate your user account
authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
description: Azure Active Directory OAuth2 Flow.
x-refined-from:
- microsoft-azure-api-management-apimanagement-resource-manager-Microsoft.ApiManagement-ApiManagement-stable-2024-05-01-apimgroups.json
- microsoft-azure-api-management-apimanagement-resource-manager-Microsoft.ApiManagement-ApiManagement-stable-2024-05-01-apimworkspaces.json