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

# Experiments

> Paywall and offering experiments, groups, and user assignment

**Experiments** enable A/B testing of paywalls, offerings, and remote configurations. Each experiment has one or more **groups** (variants), and users are attached to a specific group either automatically by audience rules or manually via the API.

## Key concepts

* **Status** — `draft`, `active`, `paused`, or `finished`. Drive transitions via `POST /v4/experiments/{experiment_id}/status`.
* **Groups** — Variants within an experiment. Each group carries a payload (offering, screen, remote config value, etc.).
* **User attachment** — `POST /v4/experiments/{experiment_id}/users/{user_id}` pins a user to a group.
* **Summary** — `/v4/experiments/summary` returns aggregated performance metrics. **Required:** `filter[experiment_uid][]` (1–50 UIDs) — discover via `GET /v4/experiments`, then iterate the summary in batches.

## Available endpoints

| Method | Endpoint                                         | Description                          | Status |
| ------ | ------------------------------------------------ | ------------------------------------ | ------ |
| GET    | `/experiments`                                   | List experiments                     | New    |
| POST   | `/experiments`                                   | Create an experiment                 | New    |
| GET    | `/experiments/summary`                           | Get experiments analytics summary    | New    |
| DELETE | `/experiments/{experiment_id}`                   | Delete an experiment                 | New    |
| GET    | `/experiments/{experiment_id}`                   | Get an experiment                    | New    |
| PATCH  | `/experiments/{experiment_id}`                   | Partially update an experiment       | New    |
| GET    | `/experiments/{experiment_id}/groups`            | List experiment groups               | New    |
| POST   | `/experiments/{experiment_id}/groups`            | Create an experiment group           | New    |
| DELETE | `/experiments/{experiment_id}/groups/{group_id}` | Delete an experiment group           | New    |
| PATCH  | `/experiments/{experiment_id}/groups/{group_id}` | Update an experiment group           | New    |
| POST   | `/experiments/{experiment_id}/status`            | Change experiment status             | New    |
| DELETE | `/experiments/{experiment_id}/users/{user_id}`   | Detach a user from an experiment     | New    |
| POST   | `/experiments/{experiment_id}/users/{user_id}`   | Attach a user to an experiment group | New    |

## Authentication

All v4 endpoints require a **Secret Key**. See [Authentication](/reference/v4/authentication).