# UnlockImpactRequest

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

Exactly one of: <code>object</code>; <code>object</code>

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>oneOf&#91;1&#93;.sourceLaunchPlanId</code> | Yes | <code>string</code> | Min length: <code>3</code>; Max length: <code>160</code> |
| <code>oneOf&#91;1&#93;.unlockIds</code> | No | Array of <code>string</code> | Min items: <code>1</code>; Max items: <code>256</code> |
| <code>oneOf&#91;1&#93;.sourceObservation</code> | Yes | [UnlockImpactSourceObservation](/api-reference/schemas/unlock-impact-source-observation/) | — |
| <code>oneOf&#91;1&#93;.reason</code> | Yes | <code>string</code> | Min length: <code>3</code>; Max length: <code>500</code> |
| <code>oneOf&#91;2&#93;.unlocks</code> | Yes | Array of [UnlockTranche](/api-reference/schemas/unlock-tranche/) | Min items: <code>1</code>; Max items: <code>256</code> |
| <code>oneOf&#91;2&#93;.sourceObservation</code> | Yes | [UnlockImpactSourceObservation](/api-reference/schemas/unlock-impact-source-observation/) | — |
| <code>oneOf&#91;2&#93;.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/UnlockImpactRequest</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).