---
title: "POST /providers/Microsoft.Management/startTenantBackfill"
method: POST
path: "/providers/Microsoft.Management/startTenantBackfill"
---

# POST /providers/Microsoft.Management/startTenantBackfill

`POST /providers/Microsoft.Management/startTenantBackfill`

Starts backfilling subscriptions for the Tenant.

## Parameters

- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref

## Response `200`

The request has succeeded.

- TenantBackfillStatusResult — The tenant backfill status
  - `tenantId` string — The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000
  - `status` 'NotStarted' | 'NotStartedButGroupsExist' | 'Started' | 'Failed' | 'Cancelled' | 'Completed' — The status of the Tenant Backfill

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2017-08-31-preview) `2a185afab701` — 1 warning, 1 info
  - deleted the `query` request parameter `api-version`
  - api tag `TenantBackfill` removed
- **2026-07-13** (2017-08-31-preview) `8a88b7130da6` — 1 breaking, 1 info
  - added the new required `query` request parameter `api-version`
  - api tag `TenantBackfill` added
- **2026-07-13** (2017-08-31-preview) `8dbdf580df07` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/management-microsoft-management-managementgroups/changes/providers/Microsoft.Management/startTenantBackfill/post.md)

---

[API](https://skmtc.dev/azure/apis/management-microsoft-management-managementgroups.md) · [All operations](https://skmtc.dev/azure/apis/management-microsoft-management-managementgroups/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/management-microsoft-management-managementgroups/revisions/2a185afab701/schema)