# Types.QueryDocumentPayload

Input payload describing a single document query.

> Kind: Apex type · Updated: 2026-07-01

Represents input for the Query Document method. One Types.QueryDocumentPayload is passed per query in the list supplied to Client.queryDocument().

## Fields

### Fields
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | String | required | The query text to run against the document. |
| processedDocumentId | String | optional | Input is optional and does not need to be provided for a direct query. |
| datasetId | String | optional | Optional dataset identifier to scope the query against. |
| agent | String | optional | Optional agent to run the query with. |

## Constructors

```apex
global QueryDocumentPayload(
    String query,
    String processedDocumentId
)
```

```apex
global QueryDocumentPayload(
    String query,
    String processedDocumentId,
    String agent
)
```

```apex
global QueryDocumentPayload(
    String query,
    String processedDocumentId,
    String datasetId,
    String agent
)
```

## Example

```apex
List<cldfs.Types.QueryDocumentPayload> queryDocuments = new List<cldfs.Types.QueryDocumentPayload>{
  new cldfs.Types.QueryDocumentPayload(
    'query',
    'processedDocumentId'
  )
};
cldfs.Client.queryDocument(queryDocuments, 'integrationUser');
```