> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents.kolena.com/llms.txt
> Use this file to discover all available pages before exploring further.

# client.validation

## `create`

```python theme={null}
create(
    agent_id: int, ground_truth_id: int
) -> CreateValidationResponse
```

Create a new validation to run against a ground truth.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `agent_id` | `int` | The ID of the agent | *required* |
| `ground_truth_id` | `int` | The ID of the ground truth to validate against | *required* |

## `get`

```python theme={null}
get(
    agent_id: int, ground_truth_id: int, validation_id: int
) -> Validation
```

Get a specific validation run.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `agent_id` | `int` | The ID of the agent | *required* |
| `ground_truth_id` | `int` | The ID of the ground truth | *required* |
| `validation_id` | `int` | The ID of the validation run to retrieve | *required* |

## `list`

```python theme={null}
list(
    agent_id: int,
    ground_truth_id: int,
    page_number: int = 0,
    page_size: int = 50,
) -> ListValidationsResponse
```

Get a paginated list of validation runs for a ground truth.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `agent_id` | `int` | The ID of the agent | *required* |
| `ground_truth_id` | `int` | The ID of the ground truth | *required* |
| `page_number` | `int` | Page number for pagination (default: 0) | `0` |
| `page_size` | `int` | Number of items per page (default: 50, max: 1000) | `50` |

## `delete`

```python theme={null}
delete(
    agent_id: int, ground_truth_id: int, validation_id: int
) -> None
```

Delete a specific validation run.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `agent_id` | `int` | The ID of the agent | *required* |
| `ground_truth_id` | `int` | The ID of the ground truth | *required* |
| `validation_id` | `int` | The ID of the validation run to delete | *required* |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.