# MigrationTransitionRequest

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

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>legId</code> | Yes | <code>string</code> | Min length: <code>3</code>; Max length: <code>160</code> |
| <code>route</code> | Yes | <code>string</code> | Allowed: <code>FORWARD</code>, <code>ROLLBACK</code> |
| <code>toStatus</code> | Yes | <code>string</code> | Allowed: <code>SUBMITTED</code>, <code>FINALIZED&#95;RECONCILED</code>, <code>FAILED&#95;FINALIZED&#95;RECONCILED</code>, <code>SKIPPED&#95;RECONCILED</code> |
| <code>previousStateHash</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>reason</code> | Yes | <code>string</code> | Min length: <code>3</code>; Max length: <code>500</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/MigrationTransitionRequest</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).