GrowthBook 5.2 adds 30 new REST API endpoints and updates 60+ more. The goal is to close the gap between what you can do in the GrowthBook app and what a script or an agent can do through the API.
Finding what's available
The REST API reference documents current endpoints by resource, such as Settings, Experiments, Data Sources, and Feature Flags. A few conventions apply across them:
- Paths are versioned.
/v1/...endpoints are stable, and/v2/...endpoints use updated shapes. For a new integration, use v2 where it exists. - A Secret Key gets the access of the role you give it, so it can only reach what that role allows.
- GrowthBook Cloud allows 60 requests per minute. A self-hosted server sets its own limit.
Getting started
Create a Secret Key under Settings → API Keys, or a Personal Access Token under Personal Access Tokens in your user menu. Send requests to https://api.growthbook.io/api on GrowthBook Cloud, or to your API_HOST if you self-host. A safe first call is GET /v1/settings, which reads your organization settings without changing them. If you self-host, GET /v1/version shows which build your server runs. The GrowthBook REST API reference covers authentication, base URLs, and the documented endpoints for each resource.
