Manage the experiment lifecycle through the REST API
GrowthBook’s expanded REST API lets you manage experiments from setup through conclusions in your own tools. A script or agent can create experiments, check launch readiness, read results, and record decisions. You choose which steps to automate and where a person reviews the work.
Work through the lifecycle
The API covers an action at each stage of an experiment:
- Create an experiment and use its pre-launch checklist to see what still needs attention.
- Mark manual checklist items complete after you finish those checks.
- Retrieve the latest results for many experiments in one call, with metric and variation names alongside their IDs when names are available.
- Record a result status, the winning variation, and an analysis summary.
Pulling results across experiments in one request makes a recurring status check practical, such as a daily summary of the latest results across your experiments.
Getting started
Create a Secret Key under Settings → API Keys, using a role with the experiment permissions your workflow needs. Use the experiment API reference to create a draft experiment, then read back its saved configuration before adding launch actions.
Available on All plans, Cloud and Self-hosted.