---
title: "Refresh Migration Entities"
method: POST
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{projectName}/refreshEntities"
tags: ["MigrateProjects"]
---

# Refresh Migration Entities

`POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{projectName}/refreshEntities`

Refresh execution status for migration entities and groups within a migrate project. This operation triggers status updates from partner migration services.

## Path parameters

- `projectName` string, required

## Parameters

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

## Request body

- RefreshEntitiesRequest — Request body for refreshing migration entities and groups.
  - `migrationEntityIds` string[] — List of migration entity ARM IDs to refresh. Each ID must be a fully qualified ARM resource ID belonging to the same subscription and resource group as the migrate project.
  - `migrationEntityGroupIds` string[] — List of migration entity group ARM IDs. All entities within these groups will be refreshed. Each ID must be a fully qualified ARM resource ID belonging to the same subscription and resource group as the migrate project.

## Response `200`

Azure operation completed successfully.

- RefreshEntitiesResponse — Response body for refresh migration entities operation.
  - `migrationEntityIds` string[] — List of migration entity ARM IDs being refreshed.
  - `migrationEntityGroupIds` string[] — List of migration entity group ARM IDs being refreshed.

## Other responses

- `202` — Resource operation accepted.
- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2025-03-30-preview) `763d4e47dd89` — 1 info
  - endpoint added
- **2025-11-04** (2025-03-30-preview) `6930e92c1fb1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/migrate-microsoft-migrate-waves/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Migrate/migrateProjects/:projectName/refreshEntities/post.md)

---

[API](https://skmtc.dev/azure/apis/migrate-microsoft-migrate-waves.md) · [All operations](https://skmtc.dev/azure/apis/migrate-microsoft-migrate-waves/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/migrate-microsoft-migrate-waves/revisions/763d4e47dd89/schema)