# Azure Management Groups management API

> Azure Management Groups management API on Apizie: 24 endpoints (Checks if the specified management group name is valid and unique, List all entities (Management Groups, Subscriptions, etc.) for the authenticated user., List management groups for the authenticated user., Get the details of the management group., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:azure-arm-management/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-arm-management`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://zieapi.vercel.app/api/cloud/azure-arm-management
- OpenAPI: https://zieapi.vercel.app/api/cloud/azure-arm-management/openapi.json

Azure Resource Manager API for Management Groups: manage these Azure resources in your subscription with a Microsoft Entra access token.

## Endpoints

### Checks if the specified management group name is valid and unique
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/check-name-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| body | object | yes | JSON request body |

### List all entities (Management Groups, Subscriptions, etc.) for the authenticated user.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/entities-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| $skiptoken | string | no | Page continuation token is only used if a previous operation returned a partial result. If a previous response contains a nextLink… |
| $skip | integer | no | Number of entities to skip over when retrieving results. Passing this in will override $skipToken. |
| $top | integer | no | Number of elements to return when retrieving results. Passing this in will override $skipToken. |
| $select | string | no | This parameter specifies the fields to include in the response. Can include any combination of… |
| $search | string | no | The $search parameter is used in conjunction with the $filter parameter to return three different outputs depending on the parameter… |
| $filter | string | no | The filter parameter allows you to filter on the the name or display name fields. You can check for equality on the name field (e.g. name… |
| $view | string | no | The view parameter allows clients to filter the type of data that is returned by the getEntities call. |
| groupName | string | no | A filter which allows the get entities call to focus on a particular group (i.e. "$filter=name eq 'groupName'") |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |

### List management groups for the authenticated user.
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-groups-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |
| $skiptoken | string | no | Page continuation token is only used if a previous operation returned a partial result. If a previous response contains a nextLink… |

### Get the details of the management group.
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-groups-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| $expand | string | no | The $expand=children query string parameter allows clients to request inclusion of children in the response payload. $expand=path includes… |
| $recurse | boolean | no | The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that… |
| $filter | string | no | A filter which allows the exclusion of subscriptions from results (i.e. '$filter=children.childType ne Subscription') |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |

### Create or update a management group. If a management group is already created and a subsequent create…
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-groups-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |
| body | object | yes | JSON request body |

### Update a management group.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-groups-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |
| body | object | yes | JSON request body |

### Delete management group. If a management group contains child resources, the request will fail.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-groups-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |

### List all entities that descend from a management group.
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-groups-get-descendants` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| $skiptoken | string | no | Page continuation token is only used if a previous operation returned a partial result. If a previous response contains a nextLink… |
| $top | integer | no | Number of elements to return when retrieving results. Passing this in will override $skipToken. |

### Gets all the hierarchy settings defined at the Management Group level. Settings can only be set on the root…
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/hierarchy-settings-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |

### Gets the hierarchy settings defined at the Management Group level. Settings can only be set on the root…
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/hierarchy-settings-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |

### Creates or updates the hierarchy settings defined at the Management Group level.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/hierarchy-settings-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| body | object | yes | JSON request body |

### Updates the hierarchy settings defined at the Management Group level.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/hierarchy-settings-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| body | object | yes | JSON request body |

### Deletes the hierarchy settings defined at the Management Group level.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/hierarchy-settings-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |

### Retrieves details about all subscriptions which are associated with the management group.
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-group-subscriptions-get-subscriptions-under-manag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| $skiptoken | string | no | Page continuation token is only used if a previous operation returned a partial result. If a previous response contains a nextLink… |

### Retrieves details about given subscription which is associated with the management group.
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-group-subscriptions-get-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| subscriptionId | string | yes | Subscription ID. |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |

### Associates existing subscription with the management group.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-group-subscriptions-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| subscriptionId | string | yes | Subscription ID. |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |

### De-associates subscription from the management group.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/management-group-subscriptions-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| groupId | string | yes | Management Group ID. |
| subscriptionId | string | yes | Subscription ID. |
| Cache-Control | string | no | Indicates whether the request should utilize any caches. Populate the header with 'no-cache' value to bypass existing caches. |

### List the operations for the provider
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/operations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |

### Starts backfilling subscriptions for the Tenant.
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/start-tenant-backfill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |

### Gets tenant backfill status
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/tenant-backfill-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |

### Get the details of the serviceGroup
`GET https://zieapi.vercel.app/v1/cloud:azure-arm-management/service-groups-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| serviceGroupName | string | yes | ServiceGroup Name. |

### Create or Update a serviceGroup
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/create-or-update-service-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| serviceGroupName | string | yes | ServiceGroup Name. |
| body | object | yes | JSON request body |

### Update a serviceGroup
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/update-service-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| serviceGroupName | string | yes | ServiceGroup Name. |
| body | object | yes | JSON request body |

### Delete a ServiceGroup
`POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/delete-service-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| serviceGroupName | string | yes | ServiceGroup Name. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:azure-arm-management/check-name-availability" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Azure Management Groups management API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:azure-arm-management/check-name-availability with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Azure Management Groups management API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Azure Management Groups management itself also needs your own key from azure.com.

### Can AI agents use the Azure Management Groups management API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-arm-management.

### What is the status of the Azure Management Groups management API?
Needs your own provider key (bring your own key)