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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API Experiments

> Un Experiment est un feature flag ou un test A/B appartenant à un compte.

Les variantes de test reçoivent des plages stables de pourcentage du trafic et tous les autres sont placés dans le groupe témoin, de sorte qu'augmenter une allocation ne déplace jamais un utilisateur existant vers un autre bras.

Utilisez l'API Experiments pour créer un brouillon, configurer ses pondérations, son ciblage et ses liaisons de ressources, puis l'activer, le mettre en pause ou y mettre fin, et pour déterminer quel bras obtient un utilisateur, un compte ou un visiteur anonyme. La gestion des expériences nécessite `experiment:read` ou `experiment:manage` ; l'évaluation fonctionne sans authentification.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les expériences](https://docs.whop.com/fr/api-reference/experiments/list-experiments.md) | GET `/experiments` |
| [Récupérer une expérience](https://docs.whop.com/fr/api-reference/experiments/retrieve-experiment.md) | GET `/experiments/{id}` |
| [Évaluer les expériences](https://docs.whop.com/fr/api-reference/experiments/evaluate-experiments.md) | GET `/experiments/exposures` |
| [Créer une expérience](https://docs.whop.com/fr/api-reference/experiments/create-experiment.md) | POST `/experiments` |
| [Activer une expérience](https://docs.whop.com/fr/api-reference/experiments/activate-experiment.md) | POST `/experiments/{id}/activate` |
| [Terminer une expérience](https://docs.whop.com/fr/api-reference/experiments/end-experiment.md) | POST `/experiments/{id}/end` |
| [Mettre en pause une expérience](https://docs.whop.com/fr/api-reference/experiments/pause-experiment.md) | POST `/experiments/{id}/pause` |
| [Mettre à jour une expérience](https://docs.whop.com/fr/api-reference/experiments/update-experiment.md) | PATCH `/experiments/{id}` |

## Attributs

**id** `string` *required*

Identifiant unique de l'expérience, préfixé par `expt_`.

**account\_id** `string` *required*

ID du compte propriétaire.

**assignment\_seed** `string` *required*

L'attribution hache la seed UTF-8 + l'ID du sujet avec CRC32 modulo 100 et
sélectionne la plage enregistrée (borne de fin exclue).

**bucket\_by** `string | null`

Unité de randomisation — `user` répartit chaque utilisateur indépendamment, `account` répartit des comptes entiers (tous les utilisateurs d'un compte obtiennent le même bras). `null` pour les feature flags.

Options disponibles : `user`, `account`, `anonymous`

**configuration\_revision** `integer` *required*

Révision de la configuration de diffusion. S'incrémente à chaque modification
de configuration, de sorte qu'une définition en cache avec une révision
inférieure est obsolète. Ne modifie pas la seed d'attribution.

**control** `object` *required*

> [accordion] Propriétés
>
> **related\_resource** `object | null`
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > Tag de la ressource référencée, appartenant au propriétaire de l'expérience.
> >
> > **object** `string` *required*
> >
> > Options disponibles : `app`, `app_build`, `product`, `plan`

**created\_at** `string | null`

Date de création de l'expérience, sous forme d'horodatage ISO 8601.

**created\_by** `string | null`

ID de l'utilisateur qui a créé l'expérience, préfixé par `user_`. `null` pour
les expériences créées avant l'enregistrement des créateurs.

**ended\_at** `string | null`

Date à laquelle l'expérience a cessé de collecter des données, sous forme
d'horodatage ISO 8601. `null` tant qu'elle est en cours.

**findings** `string | null`

Ce qui a été appris et la raison de ce résultat, enregistrés à la fin de
l'expérience. `null` jusque-là.

**flag\_key** `string` *required*

Identifiant choisi par le développeur et référencé dans le code. Partout où
l'API accepte un identifiant d'expérience, l'id `expt_` et le flag\_key sont
interchangeables.

**hypothesis** `string | null`

Hypothèse de cette expérience. `null` lorsqu'aucune n'est définie, et toujours
`null` pour les feature flags.

**metadata** `object`

Paires clé-valeur associées lors de la création de l'expérience. Vide
lorsqu'aucune n'a été définie.

**name** `string` *required*

Nom d'affichage lisible.

**related\_resource** `object | null` *required*

Ressource appartenant au compte à laquelle cette expérience est liée, comme une app ou un produit. `null` lorsqu'elle n'est pas liée. Figée dès la première activation de l'expérience.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> Tag de la ressource référencée, appartenant au propriétaire de l'expérience.
>
> **object** `string` *required*
>
> Options disponibles : `app`, `app_build`, `product`, `plan`

**started\_at** `string | null`

Date à laquelle l'expérience a commencé à collecter des données, sous forme
d'horodatage ISO 8601. `null` pour les brouillons.

**status** `string` *required*

État du cycle de vie. `draft` — pas encore en ligne ; `active` — en cours ; `paused` — trafic en pause ; `ended` — terminée.

Options disponibles : `draft`, `active`, `paused`, `ended`

**updated\_at** `string | null` *required*

**variants** `object[]` *required*

Bras de test. Les utilisateurs situés en dehors de l'allocation de tous les bras forment le groupe `control` implicite. Les pondérations ne font qu'augmenter et les bras ne sont jamais supprimés, de sorte qu'un utilisateur passe du groupe témoin à une variante au plus une fois.

> [accordion] Propriétés
>
> **name** `string` *required*
>
> Identifiant de la variante. `control` est réservé — il correspond au reste
> implicite.
>
> **ranges** `integer[][]`
>
> Plages de buckets attribuées (unités de 1 %, borne de fin exclue) qui
> enregistrent l'historique d'allocation de ce bras. Gérées par le serveur ; les
> plages sont uniquement ajoutées, ce qui garantit la permanence des
> attributions.
>
> **related\_resource** `object | null`
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > Tag de la ressource référencée, appartenant au propriétaire de l'expérience.
> >
> > **object** `string` *required*
> >
> > Options disponibles : `app`, `app_build`, `product`, `plan`
>
> **weight** `integer` *required*
>
> Pourcentage de l'ensemble des utilisateurs attribués à cette variante, de 1 à 100. La somme de toutes les pondérations est au maximum de 100 ; le reste constitue le groupe témoin.

**winning\_arm** `string | null`

La variante gagnante, définie à la fin de l'expérience. Une fois définie,
chaque évaluation renvoie ce bras à chaque appelant, quels que soient le
ciblage ou l'allocation, et aucune exposition supplémentaire n'est
enregistrée. `null` signifie que le groupe témoin a gagné — une expérience
terminée sans bras gagnant renvoie `control` pour tout le monde. Toujours
`null` pour les feature flags, qui sont simplement évalués comme désactivés
une fois terminés.

```json Experiment theme={null}
{
	"id": "expt_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"flag_key": "checkout_redesign_v2",
	"name": "Checkout Redesign V2",
	"hypothesis": "A single-step checkout raises conversion.",
	"status": "active",
	"bucket_by": "user",
	"assignment_seed": "checkout_redesign_v21789462000",
	"configuration_revision": 2,
	"variants": [
		{
			"name": "treatment",
			"weight": 50,
			"ranges": [[0, 50]],
			"related_resource": null
		}
	],
	"control": {
		"related_resource": null
	},
	"related_resource": null,
	"winning_arm": null,
	"findings": null,
	"created_by": "user_xxxxxxxxxxxxxx",
	"created_at": "2026-09-01T12:00:00.000Z",
	"started_at": "2026-09-02T09:00:00.000Z",
	"ended_at": null,
	"updated_at": "2026-09-02T09:00:00.000Z"
}
```


## Related topics

- [Evaluate Experiments](https://docs.whop.com/fr/api-reference/experiments/evaluate-experiments.md)
- [Pause Experiment](https://docs.whop.com/fr/api-reference/experiments/pause-experiment.md)
- [Activate Experiment](https://docs.whop.com/fr/api-reference/experiments/activate-experiment.md)
