Experiments API

Manage A/B tests and experiments.

List Experiments

GET /v1/experiments

Response:

{
  "data": [
    {
      "id": "exp_123",
      "key": "checkout-v2",
      "status": "running",
      "variants": ["control", "variant-a"],
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ]
}

Get Experiment

GET /v1/experiments/:key

Response:

{
  "data": {
    "id": "exp_123",
    "key": "checkout-v2",
    "status": "running",
    "variants": [
      { "key": "control", "weight": 50 },
      { "key": "variant-a", "weight": 50 }
    ],
    "metrics": ["conversion_rate", "revenue"],
    "results": {
      "control": { "conversion": 0.12, "sampleSize": 5000 },
      "variant-a": { "conversion": 0.15, "sampleSize": 4800 }
    }
  }
}

Create Experiment

POST /v1/experiments

Request:

{
  "key": "checkout-v2",
  "description": "Test new checkout flow",
  "variants": [
    { "key": "control", "weight": 50 },
    { "key": "variant-a", "weight": 50 }
  ],
  "metrics": ["conversion_rate"]
}

Start Experiment

POST /v1/experiments/:key/start

Stop Experiment

POST /v1/experiments/:key/stop

Get Variant

POST /v1/experiments/:key/variant

Request:

{
  "userId": "user-123"
}

Response:

{
  "data": {
    "variant": "variant-a",
    "experimentId": "exp_123"
  }
}