# MigrationPlan

[All API schemas](/api-reference/schemas/)

<code>object</code> — Additional properties rejected

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>plannerVersion</code> | Yes | Constant <code>liquidity-migration-v1</code> | — |
| <code>stateMachineVersion</code> | Yes | Constant <code>liquidity-migration-state-v1</code> | — |
| <code>executionVaultId</code> | No | <code>string</code> | Required for AUDITED_TYPED_ADAPTER plans and omitted for PREVIEW_ONLY plans. |
| <code>sourceVenueId</code> | Yes | <code>string</code> | — |
| <code>targetVenueId</code> | Yes | <code>string</code> | — |
| <code>sourceVenueBinding</code> | Yes | [MigrationVenueProfileBinding](/api-reference/schemas/migration-venue-profile-binding/) | — |
| <code>targetVenueBinding</code> | Yes | [MigrationVenueProfileBinding](/api-reference/schemas/migration-venue-profile-binding/) | — |
| <code>capitalQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>temporaryDepthReductionQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>expectedPriceImpactPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>migrationCostQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>expectedMarketQualityImprovement</code> | Yes | <code>integer</code> | — |
| <code>executionClass</code> | Yes | <code>string</code> | Allowed: <code>PREVIEW&#95;ONLY</code>, <code>AUDITED&#95;TYPED&#95;ADAPTER</code> |
| <code>legs</code> | Yes | Array of [MigrationPlanLeg](/api-reference/schemas/migration-plan-leg/) | — |
| <code>rollbackLegs</code> | Yes | Array of [MigrationPlanLeg](/api-reference/schemas/migration-plan-leg/) | — |
| <code>rollbackReason</code> | Yes | <code>string</code> | — |
| <code>assumptions</code> | Yes | Array of <code>string</code> | — |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Exact definition: <code>#/components/schemas/MigrationPlan</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).