# AgentClarification

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

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>schemaVersion</code> | Yes | Constant <code>agent-clarification-v1</code> | — |
| <code>questionId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>prompt</code> | Yes | <code>string</code> | Min length: <code>3</code>; Max length: <code>2000</code> |
| <code>contextHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>options</code> | Yes | Array of <code>object</code> | Min items: <code>2</code>; Max items: <code>6</code> |
| <code>options&#91;&#93;.id</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>options&#91;&#93;.label</code> | Yes | <code>string</code> | Min length: <code>1</code>; Max length: <code>160</code> |
| <code>options&#91;&#93;.description</code> | Yes | <code>string</code> | Min length: <code>1</code>; Max length: <code>1000</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/AgentClarification</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).