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

# POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{projectName}/generateWavePlan

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

A long-running resource action.

## 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

- GenerateWavePlanRequest — Data model of Download URL for wave recommendation report.
  - `assessmentArmId` string — ARM Id of the assessment for which the wave plan report is to be generated.
  - `migrationPath` string — Optional. Specify the migration path for which the wave plan report is to be generated. If not specified, the default will be used

## Response `200`

Azure operation completed successfully.

- GenerateWavePlanResponse — Data model of Download URL for wave recommendation report.
  - `sasUri` string, required — Hyperlink to download report.
  - `expirationTime` string, date-time, required — Expiry date of download url.

## Other responses

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

## Changes

- **2026-07-13** (2025-03-30-preview) `7d81b948ea86` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2025-03-30-preview) `e53baa59d062` — 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/generateWavePlan/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)