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

# Test Suites

> Organize test cases into executable or logical groupings

# Test Suites

A **Test Suite** is a collection of test cases. Test suites come in two types:

## Executable vs Logical

| Type           | `executable` | Description                                                                                 |
| -------------- | ------------ | ------------------------------------------------------------------------------------------- |
| **Executable** | `true`       | Automatically created and tied to a specific table. Contains all test cases for that table. |
| **Logical**    | `false`      | User-defined grouping of test cases across multiple tables for organized reporting.         |

<Info>
  Executable test suites are automatically created when you add the first test case to a table. Logical test suites are created manually to group related tests across tables.
</Info>

## Fully Qualified Name

The FQN for a test suite is its name:

```
b5fcae09-02c2-4c0b-8c4a-5b52d650e592
```

***

## API Endpoints

| Method   | Endpoint                                   | Description                                                                   |
| -------- | ------------------------------------------ | ----------------------------------------------------------------------------- |
| `POST`   | `/v1/dataQuality/testSuites`               | [Create a test suite](/v1.12.x/api-reference/data-quality/test-suites/create) |
| `GET`    | `/v1/dataQuality/testSuites`               | [List test suites](/v1.12.x/api-reference/data-quality/test-suites/list)      |
| `GET`    | `/v1/dataQuality/testSuites/{id}`          | [Get by ID](/v1.12.x/api-reference/data-quality/test-suites/retrieve)         |
| `GET`    | `/v1/dataQuality/testSuites/name/{fqn}`    | [Get by name](/v1.12.x/api-reference/data-quality/test-suites/retrieve)       |
| `PATCH`  | `/v1/dataQuality/testSuites/{id}`          | [Update by ID](/v1.12.x/api-reference/data-quality/test-suites/update)        |
| `DELETE` | `/v1/dataQuality/testSuites/{id}`          | [Delete by ID](/v1.12.x/api-reference/data-quality/test-suites/delete)        |
| `GET`    | `/v1/dataQuality/testSuites/{id}/versions` | [List versions](/v1.12.x/api-reference/data-quality/test-suites/versions)     |