Reference

REST API

Manage experiments programmatically. Bearer-authenticated.

Authenticate with your MCP/API token (Settings → MCP access) as a Bearer credential. All endpoints are tenant-scoped to that token.

bash
curl https://maxlift.io/api/experiments \
  -H "Authorization: Bearer ml_mcp_your_token"

Endpoints

Method	Path	Purpose
GET	/api/templates	List experiment templates (public)
GET	/api/experiments	List your experiments
POST	/api/experiments	Create an experiment (draft)
GET	/api/experiments/:id	Experiment detail + counters
PATCH	/api/experiments/:id	Change status (launch/pause/archive)
GET	/api/experiments/:id/verdict	Statistical verdict
POST	/api/experiments/:id/promote-winner	Promote the winner
GET	/api/ruleset?tenant=:id	Compiled ruleset for the SDK
POST	/api/track	Ingest exposure/conversion events

Create an experiment

bash
curl -X POST https://maxlift.io/api/experiments \
  -H "Authorization: Bearer ml_mcp_your_token" \
  -H "content-type: application/json" \
  -d '{
    "key": "pricing_test",
    "name": "Anchor pricing",
    "traffic_allocation": 100,
    "primary_metric": "conversion",
    "variations": [
      { "key": "control", "weight": 50 },
      { "key": "treatment", "weight": 50 }
    ]
  }'

Start free All docs