GrowthBook

https://docs.growthbook.io/
Admin
GrowthBook is an open-source platform for feature flagging and A/B testing, built to empower data...
Tokens:2,846,761
Snippets:11,516
Trust Score:8.8
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Go example for start-checklist

Source: https://docs.growthbook.io/api/experiments/operation/getExperimentStartChecklist

Go example using net/http to GET the start checklist. Replace '{id}' with the experiment ID and '<token>' with your API key.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/experiments/{id}/start-checklist"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby example for start-checklist

Source: https://docs.growthbook.io/api/experiments/operation/getExperimentStartChecklist

Ruby example using net/http to GET the start checklist. Replace '{id}' with the experiment ID and '<token>' with your API key.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.growthbook.io/api/v1/experiments/{id}/start-checklist")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Start Holdout with Go net/http

Source: https://docs.growthbook.io/api/Holdouts/operation/startHoldout

Go example using net/http to start a holdout. Replace {id} and <token> with your values.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/holdouts/{id}/start"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

--------------------------------

### Go GET learning

Source: https://docs.growthbook.io/api/Learnings/operation/getLearning

Go example using net/http to GET a learning. Replace {id} and <token> with your values.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/learnings/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Quick start: initialize SDK and evaluate features

Source: https://docs.growthbook.io/lib/ruby

Set up the GrowthBook client, fetch features, create a context, and evaluate boolean and multivariate features.

```ruby
require 'growthbook'

# Fetch features from a GrowthBook instance
# You should cache this in Redis or similar in production
features_repository = Growthbook::FeatureRepository.new(
  endpoint: 'https://cdn.growthbook.io/api/features/MY_API_KEY',
  decryption_key: nil
)
features = features_repository.fetch

# Create a context for the current user/request
gb = Growthbook::Context.new(
  features: features,
  # User attributes for targeting / variation assignment
  attributes: {
    id: '123',
    country: 'US'
  }
)

# Use a boolean feature flag
if gb.on? :my_feature_key
  puts 'My feature is on!'
end

# Get the value of a multivariate feature with a fallback
btn_color = gb.feature_value(:signup_btn_color, 'pink')

```

--------------------------------

### Java Unirest example for start-checklist

Source: https://docs.growthbook.io/api/experiments/operation/getExperimentStartChecklist

Java example using Unirest to GET the start checklist. Replace '{id}' with the experiment ID and '<token>' with your API key.

```java
HttpResponse<String> response = Unirest.get("https://api.growthbook.io/api/v1/experiments/{id}/start-checklist")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Create React App and install GrowthBook SDK

Source: https://docs.growthbook.io/guide/create-react-app-and-growthbook

Initializes a new Create React App project, installs the GrowthBook SDK and nanoid, and starts the development server.

```bash
npx create-react-app my-app
cd my-app
npm install --save @growthbook/growthbook-react nanoid
npm start

```

--------------------------------

### PHP cURL example for start-checklist

Source: https://docs.growthbook.io/api/experiments/operation/getExperimentStartChecklist

PHP example using cURL to GET the start checklist. Replace '{id}' with the experiment ID and '<token>' with your API key.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growthbook.io/api/v1/experiments/{id}/start-checklist",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Go example for config schema

Source: https://docs.growthbook.io/api/configs/operation/getConfigSchema

Go example using the standard library to fetch the config schema. Replace {key} and <token> with your values.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/configs/{key}/schema"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Quick Usage: Initialize client and evaluate features

Source: https://docs.growthbook.io/lib/go

Complete example showing client initialization with SSE data source, waiting for data load, creating a child client with attributes, and evaluating text and boolean features. The client is thread-safe and should be closed with defer client.Close().

```go
import (
    "context"
    "log"
    gb "github.com/growthbook/growthbook-golang"
)

// Create a new client instance with a client key and a data source that loads features
// in the background using an SSE stream. Pass the client's options to the NewClient function.
client, err := gb.NewClient(
    context.Background(),
    gb.WithClientKey("sdk-XXXX"),
    gb.WithSseDataSource(),
)
defer client.Close()

if err != nil {
    log.Fatal("Client initialization failed: ", err)
}

// The data source starts asynchronously. Use EnsureLoaded to wait until the client data
// is initialized for the first time.
if err := client.EnsureLoaded(context.Background()); err != nil {
    log.Fatal("Data loading failed: ", err)
}

// Create a child client with specific attributes.
attrs := gb.Attributes{"id": 100, "user": "user1"}
child, err := client.WithAttributes(attrs)
if err != nil {
    log.Fatal("Child client creation failed: ", err)
}

// Evaluate a text feature.
buttonColor := child.EvalFeature(context.Background(), "buy-button-color")
if buttonColor.Value == "blue" {
    // Perform actions for blue button.
}

// Evaluate a boolean feature.
darkMode := child.EvalFeature(context.Background(), "dark-mode")
if darkMode.On {
    // Enable dark mode.
}

```

--------------------------------

### JavaScript fetch example for start-checklist

Source: https://docs.growthbook.io/api/experiments/operation/getExperimentStartChecklist

JavaScript example using fetch to GET the start checklist. Replace '{id}' with the experiment ID and '<token>' with your API key.

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growthbook.io/api/v1/experiments/{id}/start-checklist', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Python requests example for start-checklist

Source: https://docs.growthbook.io/api/experiments/operation/getExperimentStartChecklist

Python example using the requests library to GET the start checklist. Replace '{id}' with the experiment ID and '<token>' with your API key.

```python
import requests

url = "https://api.growthbook.io/api/v1/experiments/{id}/start-checklist"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

--------------------------------

### Go example

Source: https://docs.growthbook.io/api/constants/operation/getConstantReferences

Go example using net/http. Replace {key} and <token> with your values.

```Go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/constants/{key}/references"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Java Unirest example

Source: https://docs.growthbook.io/api/metrics/operation/listMetricExperiments

Java example using Unirest to make the GET request with a Bearer token and get the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://api.growthbook.io/api/v1/metrics/{id}/experiments?limit=10")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Go example for creating environment

Source: https://docs.growthbook.io/api/environments/operation/postEnvironment

Uses the net/http package to send a POST request with a JSON string payload. The payload includes id, description, toggleOnList, defaultState, projects, and parent fields.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/environments"

	payload := strings.NewReader("{\n  \"id\": \"<string>\",\n  \"description\": \"<string>\",\n  \"toggleOnList\": true,\n  \"defaultState\": true,\n  \"projects\": [\n    \"<string>\"\n  ],\n  \"parent\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Quick Start: Initialize GrowthBook SDK and Evaluate Features

Source: https://docs.growthbook.io/lib/kotlin-jvm

Sets up the GrowthBook SDK with user attributes, a network dispatcher, and a tracking callback, then fetches features and evaluates feature flags and an inline experiment. Requires an API key and host, and uses OkHttp for network requests.

```kotlin
import com.sdk.growthbook.GBSDKBuilder
import com.sdk.growthbook.model.GBExperiment
import com.sdk.growthbook.model.toGbString
import com.sdk.growthbook.network.GBNetworkDispatcherOkHttp

suspend fun main() {
    // User attributes for targeting and experiments
    val attributes = mapOf(
        "id" to "user_123".toGbString(),
        "environment" to "production".toGbString(),
        "organization" to "acme-corp".toGbString(),
        "role" to "admin".toGbString()
    )

    // Create network dispatcher (OkHttp recommended for servers)
    val networkDispatcher = GBNetworkDispatcherOkHttp()

    // Build GrowthBook SDK instance
    val growthBook = GBSDKBuilder(
        apiKey = "sdk_abc123",
        apiHost = "https://cdn.growthbook.io/",
        attributes = attributes,
        networkDispatcher = networkDispatcher,
        trackingCallback = { experiment, result ->
            // Track experiment views in your analytics
            println("Experiment: ${experiment.key}, Variation: ${result.variationId}")
        }
    ).initialize()

    // Fetch feature definitions
    growthBook.refreshCache()

    // Evaluate feature flags
    val newFeatureEnabled = growthBook.feature("new-checkout-flow").on
    val maxRetries = growthBook.featureValue<Int>("max-retries") ?: 3

    println("New checkout flow: $newFeatureEnabled")
    println("Max retries: $maxRetries")

    // Run inline experiments
    val buttonColorExperiment = growthBook.run(
        GBExperiment(
            key = "button-color-test",
            variations = listOf("blue", "red", "green").map { it.toGbString() }
        )
    )

    println("Button color: ${buttonColorExperiment.value}")
}

```

--------------------------------

### Install GrowthBook Go SDK with go get

Source: https://docs.growthbook.io/lib/go

Install the growthbook-golang package using the go get command. Requires Go version 1.21 or higher.

```bash
go get github.com/growthbook/growthbook-golang

```

--------------------------------

### Go example for list learnings

Source: https://docs.growthbook.io/api/Learnings/operation/listLearnings

Go example using net/http to fetch learnings. Replace <token> with your API key.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/learnings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### List dimensions - GET /api/v1/dimensions

Source: https://docs.growthbook.io/api/dimensions/operation/listDimensions

Example requests to list dimensions using the GrowthBook API. Each example uses the GET /api/v1/dimensions endpoint with an Authorization header. The cURL example uses YOUR_API_KEY placeholder, while others use <token>.

```cURL
curl -X GET 'https://api.growthbook.io/api/v1/dimensions' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```Python
import requests

url = "https://api.growthbook.io/api/v1/dimensions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```JavaScript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growthbook.io/api/v1/dimensions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growthbook.io/api/v1/dimensions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```Go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/dimensions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```Java
HttpResponse<String> response = Unirest.get("https://api.growthbook.io/api/v1/dimensions")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```Ruby
require 'uri'
require 'net/http'

url = URI("https://api.growthbook.io/api/v1/dimensions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Get Metric Usage API Request Examples

Source: https://docs.growthbook.io/api/usage/operation/getMetricUsage

Send a GET request to the GrowthBook API endpoint /api/v1/usage/metrics with an Authorization header. The cURL example uses YOUR_API_KEY placeholder, while the other language examples use <token> placeholder. All examples return the metric usage data as a JSON response.

```bash
curl -X GET 'https://api.growthbook.io/api/v1/usage/metrics' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```python
import requests

url = "https://api.growthbook.io/api/v1/usage/metrics"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growthbook.io/api/v1/usage/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growthbook.io/api/v1/usage/metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/usage/metrics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.growthbook.io/api/v1/usage/metrics")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.growthbook.io/api/v1/usage/metrics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### GET /settings 200 response body

Source: https://docs.growthbook.io/api/settings/operation/getSettings

Example response body for a successful GET /settings request. Shows the full settings object with placeholders for string values and numeric examples for numeric fields.

```json
{
  "settings": {
    "confidenceLevel": 123,
    "northStar": {
      "title": "<string>",
      "metricIds": [
        "<string>"
      ]
    },
    "metricDefaults": {
      "priorSettings": {
        "override": true,
        "proper": true,
        "mean": 123,
        "stddev": 123
      },
      "minimumSampleSize": 123,
      "maxPercentageChange": 123,
      "minPercentageChange": 123,
      "targetMDE": 123
    },
    "pastExperimentsMinLength": 123,
    "metricAnalysisDays": 123,
    "updateSchedule": {
      "type": "cron",
      "cron": "<string>",
      "hours": 123
    },
    "multipleExposureMinPercent": 123,
    "defaultRole": {
      "role": "<string>",
      "limitAccessByEnvironment": true,
      "environments": [
        "<string>"
      ]
    },
    "statsEngine": "<string>",
    "pValueThreshold": 123,
    "regressionAdjustmentEnabled": true,
    "regressionAdjustmentDays": 123,
    "sequentialTestingEnabled": true,
    "sequentialTestingTuningParameter": 123,
    "attributionModel": "firstExposure",
    "targetMDE": 123,
    "delayHours": 123,
    "windowType": "<string>",
    "windowHours": 123,
    "winRisk": 123,
    "loseRisk": 123,
    "secureAttributeSalt": "<string>",
    "killswitchConfirmation": true,
    "requireReviews": [
      {
        "requireReviewOn": true,
        "projects": [
          "<string>"
        ],
        "resetReviewOnChange": true,
        "environments": [
          "<string>"
        ],
        "featureRequireEnvironmentReview": true,
        "featureRequireMetadataReview": true,
        "blockSelfApproval": true,
        "autopublishOnApproval": true,
        "requiredApproverTeams": [
          "<string>"
        ]
      }
    ],
    "approvalFlows": {
      "savedGroups": [
        {
          "required": true,
          "projects": [
            "<string>"
          ],
          "resetReviewOnChange": true,
          "requireMetadataReview": true,
          "blockSelfApproval": true,
          "autopublishOnApproval": true,
          "requiredApproverTeams": [
            "<string>"
          ]
        }
      ]
    },
    "featureKeyExample": "<string>",
    "featureRegexValidator": "<string>",
    "banditScheduleValue": 123,
    "banditScheduleUnit": "hours",
    "banditBurnInValue": 123,
    "banditBurnInUnit": "hours",
    "experimentMinLengthDays": 123,
    "featureKillSwitchBehavior": "off",
    "targetingReviewMode": [
      {
        "projects": [
          "<string>"
        ],
        "mode": "strict"
      }
    ],
    "restApiBypassesReviews": true,
    "requireRebaseBeforePublish": true,
    "revertsBypassApproval": true,
    "maxConcurrentDrafts": 123,
    "sparseJSONRulesByDefault": true,
    "experimentMaxLengthDays": 123,
    "preferredEnvironment": "<string>",
    "maxMetricSliceLevels": 123,
    "topValuesLookbackValue": 123,
    "topValuesLookbackUnit": "days"
  }
}
```

--------------------------------

### Set up GrowthBook OpenFeature provider in Go

Source: https://docs.growthbook.io/lib/openfeature

Go example that creates a GrowthBook client with API host and client key, wraps it in the OpenFeature provider, and registers it with the OpenFeature SDK. The snippet initializes a client for feature flag evaluation.

```go
import (
    "context"
    "log"
    gb "github.com/growthbook/growthbook-golang"
    gbprovider "github.com/growthbook/growthbook-openfeature-provider-go"
    "github.com/open-feature/go-sdk/openfeature"
)

// Create the underlying GrowthBook client
gbClient, err := gb.NewClient(context.Background(),
    gb.WithAPIHost("https://cdn.growthbook.io"),
    gb.WithClientKey("sdk-abc123"),
)
if err != nil {
    log.Fatal("GrowthBook client initialization failed: ", err)
}
defer gbClient.Close()

// Wrap it in the OpenFeature provider and register it
provider := gbprovider.NewProvider(gbClient)
if err = openfeature.SetProvider(provider); err != nil {
    log.Fatal("Failed to set OpenFeature provider: ", err)
}

client := openfeature.NewClient("my-app")
```

--------------------------------

### Get Feature Revisions Response Example

Source: https://docs.growthbook.io/api/feature-revisions-v2/operation/getFeatureRevisionsV2

Example JSON response for a successful request to get feature revisions. Shows the structure of the revisions array with fields like id, featureId, version, status, and rules.

```json
{
  "revisions": [
    {
      "id": "<string>",
      "featureId": "<string>",
      "baseVersion": 123,
      "version": 123,
      "comment": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "status": "<string>",
      "rules": [
        {
          "description": "<string>",
          "id": "<string>",
          "enabled": true,
          "type": "force",
          "value": "<string>",
          "allEnvironments": true,
          "condition": "<string>",
          "scheduleRules": [
            {
              "enabled": true,
              "timestamp": "2023-11-07T05:31:56Z"
            }
          ],
          "scheduleType": "none",
          "rampScheduleId": "<string>",
          "savedGroupTargeting": [
            {
              "matchType": "all",
              "savedGroups": [
                "<string>"
              ]
            }
          ],
          "prerequisites": [
            {
              "id": "<string>",
              "condition": "<string>"
            }
          ],
          "allProjects": true,
          "projects": [
            "<string>"
          ]
        }
      ]
    }
  ]
}
```

--------------------------------

### GET information-schema endpoint examples

Source: https://docs.growthbook.io/api/data-sources/operation/getInformationSchema

Example requests for the GET /data-sources/{dataSourceId}/information-schema endpoint. All require an Authorization header with a Bearer token (Secret Key). The response is a JSON object containing the information schema.

```cURL
curl -X GET 'https://api.growthbook.io/api/v1/data-sources/{dataSourceId}/information-schema' \
  -H 'Authorization: Bearer YOUR_API_KEY'

```

```Python
import requests

url = "https://api.growthbook.io/api/v1/data-sources/{dataSourceId}/information-schema"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

```

```JavaScript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growthbook.io/api/v1/data-sources/{dataSourceId}/information-schema', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

```

```PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growthbook.io/api/v1/data-sources/{dataSourceId}/information-schema",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

```

```Go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/data-sources/{dataSourceId}/information-schema"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

```Java
HttpResponse<String> response = Unirest.get("https://api.growthbook.io/api/v1/data-sources/{dataSourceId}/information-schema")
  .header("Authorization", "Bearer <token>")
  .asString();

```

```Ruby
require 'uri'
require 'net/http'

url = URI("https://api.growthbook.io/api/v1/data-sources/{dataSourceId}/information-schema")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

```

--------------------------------

### Start development server

Source: https://docs.growthbook.io/guides-for-agents/nextjs-app-router-production-feature-flags

Start the Next.js development server.

```bash
npm run dev

```

--------------------------------

### Create .env.example for GrowthBook configuration

Source: https://docs.growthbook.io/guides-for-agents/free-ab-test-javascript

Create the .env.example file with the public client key, API host, ingestor host, and environment variables. Replace the client key placeholder with the actual key. For a Managed Warehouse in eu-west-1, use the regional ingestor host instead.

```bash
VITE_GROWTHBOOK_CLIENT_KEY=sdk_REPLACE_WITH_PUBLIC_CLIENT_KEY
VITE_GROWTHBOOK_API_HOST=https://cdn.growthbook.io
VITE_GROWTHBOOK_INGESTOR_HOST=https://us1.gb-ingest.com
VITE_APP_ENVIRONMENT=development
VITE_APP_VERSION=local

```

--------------------------------

### GET /v1/features

Source: https://docs.growthbook.io/api

Example of authenticating and calling the GET /v1/features endpoint using HTTP Basic authentication.

```APIDOC
## [GET] /v1/features

### Description
Fetches the list of features from the GrowthBook API. This endpoint is used to retrieve feature flag definitions.

### Method
GET

### Endpoint
/v1/features

### Authentication
HTTP Basic or Bearer authentication with a valid API key.

### Request Example
```
curl https://api.growthbook.io/api/v1/features \
  -u secret_abc123DEF456:
```

### Response
#### Success Response (200)
- **message** (string) - Information about the error (only present on error responses)

#### Response Example
```json
{
  "message": "Information about the error"
}
```
```

--------------------------------

### GET /api/v1/revisions

Source: https://docs.growthbook.io/api/feature-revisions/operation/listRevisions

Documentation for the GET /api/v1/revisions endpoint, including parameters, request example, and response schema.

```APIDOC
## GET /api/v1/revisions

### Description
Retrieves a list of feature revisions from the GrowthBook API.

### Method
GET

### Endpoint
https://api.growthbook.io/api/v1/revisions

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Limits the number of revisions returned.

### Request Example
```
curl -X GET 'https://api.growthbook.io/api/v1/revisions' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Response
#### Success Response (200)
- **revisions** (array) - List of revision objects.
  - **id** (string) - Revision ID.
  - **featureId** (string) - ID of the associated feature.
  - **baseVersion** (integer) - Base version number.
  - **version** (integer) - Revision version number.
  - **comment** (string) - Comment associated with the revision.
  - **date** (string) - Date of the revision.
  - **status** (string) - Status of the revision.
  - **rules** (object) - Rules associated with the revision.
  - **createdBy** (string) - User who created the revision.
  - **publishedBy** (string) - User who published the revision.
  - **defaultValue** (string) - Default value of the feature.
  - **definitions** (object) - Definitions associated with the revision.
  - **environmentsEnabled** (object) - Environments where the feature is enabled.
  - **envPrerequisites** (object) - Environment prerequisites.
  - **prerequisites** (array) - List of prerequisites.
    - **id** (string) - Prerequisite ID.
    - **condition** (string) - Condition for the prerequisite.
  - **metadata** (object) - Metadata for the revision.
    - **description** (string) - Description.
    - **owner** (string) - Owner.
    - **project** (string) - Project.
    - **tags** (array) - Tags.
    - **neverStale** (boolean) - Whether the revision is never stale.
    - **valueType** (string) - Value type.
    - **jsonSchema** (object) - JSON schema.
      - **schemaType** (string) - Schema type.
      - **schema** (string) - Schema.
      - **simple** (object) - Simple schema.
      - **date** (string) - Date.
      - **enabled** (boolean) - Whether schema is enabled.
    - **customFields** (object) - Custom fields.
    - **baseConfig** (string) - Base configuration.
  - **rampActions** (array) - List of ramp actions.
    - **mode** (string) - Mode.
    - **ruleId** (string) - Rule ID.
    - **name** (string) - Name.
    - **environment** (string) - Environment.
    - **templateId** (string) - Template ID.
    - **startActions** (array) - Start actions.
      - **patch** (object) - Patch.
        - **ruleId** (string) - Rule ID.
        - **coverage** (number) - Coverage.
        - **condition** (string) - Condition.
        - **savedGroups** (array) - Saved groups.
          - **match** (string) - Match type.
          - **ids** (array) - IDs.
        - **prerequisites** (array) - Prerequisites.
          - **id** (string) - ID.
          - **condition** (string) - Condition.
        - **allEnvironments** (boolean) - Whether all environments are affected.
        - **environments** (array) - Environments.
        - **force** (unknown) - Force value.
        - **enabled** (boolean) - Whether enabled.
        - **hashAttribute** (string) - Hash attribute.
        - **seed** (string) - Seed.
        - **hashVersion** (integer) - Hash version.
      - **targetType** (string) - Target type.
      - **targetId** (string) - Target ID.
    - **steps** (array) - Steps.
      - **interval** (integer) - Interval.
      - **actions** (array) - Actions.
        - **patch** (object) - Patch.
          - **ruleId** (string) - Rule ID.
          - **coverage** (number) - Coverage.
          - **condition** (string) - Condition.
          - **savedGroups** (array) - Saved groups.
            - **match** (string) - Match type.
            - **ids** (array) - IDs.
          - **prerequisites** (array) - Prerequisites.
            - **id** (string) - ID.
            - **condition** (string) - Condition.
          - **allEnvironments** (boolean) - Whether all environments are affected.
          - **environments** (array) - Environments.
          - **force** (unknown) - Force value.
          - **enabled** (boolean) - Whether enabled.
          - **hashAttribute** (string) - Hash attribute.
          - **seed** (string) - Seed.
          - **hashVersion** (integer) - Hash version.
        - **targetType** (string) - Target type.
        - **targetId** (string) - Target ID.

#### Response Example
```
{
  "revisions": [
    {
      "id": "<string>",
      "featureId": "<string>",
      "baseVersion": 123,
      "version": 123,
      "comment": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "status": "<string>",
      "rules": {},
      "createdBy": "<string>",
      "publishedBy": "<string>",
      "defaultValue": "<string>",
      "definitions": {},
      "environmentsEnabled": {},
      "envPrerequisites": {},
      "prerequisites": [
        {
          "id": "<string>",
          "condition": "<string>"
        }
      ],
      "metadata": {
        "description": "<string>",
        "owner": "<string>",
        "project": "<string>",
        "tags": [
          "<string>"
        ],
        "neverStale": true,
        "valueType": "<string>",
        "jsonSchema": {
          "schemaType": "schema",
          "schema": "<string>",
          "simple": {},
          "date": "2023-11-07T05:31:56Z",
          "enabled": true
        },
        "customFields": {},
        "baseConfig": "<string>"
      },
      "rampActions": [
        {
          "mode": "create",
          "ruleId": "<string>",
          "name": "<string>",
          "environment": "<string>",
          "templateId": "<string>",
          "startActions": [
            {
              "patch": {
                "ruleId": "<string>",
                "coverage": 0.5,
                "condition": "<string>",
                "savedGroups": [
                  {
                    "match": "all",
                    "ids": [
                      "<string>"
                    ]
                  }
                ],
                "prerequisites": [
                  {
                    "id": "<string>",
                    "condition": "<string>"
                  }
                ],
                "allEnvironments": true,
                "environments": [
                  "<string>"
                ],
                "force": "<unknown>",
                "enabled": true,
                "hashAttribute": "<string>",
                "seed": "<string>",
                "hashVersion": 1
              },
              "targetType": "feature-rule",
              "targetId": "<string>"
            }
          ],
          "steps": [
            {
              "interval": 1,
              "actions": [
                {
                  "patch": {
                    "ruleId": "<string>",
                    "coverage": 0.5,
                    "condition": "<string>",
                    "savedGroups": [
                      {
                        "match": "all",
                        "ids": [
                          "<string>"
                        ]
                      }
                    ],
                    "prerequisites": [
                      {
                        "id": "<string>",
                        "condition": "<string>"
                      }
                    ],
                    "allEnvironments": true,
                    "environments": [
                      "<string>"
                    ],
                    "force": "<unknown>",
                    "enabled": true,
                    "hashAttribute": "<string>",
                    "seed": "<string>",
                    "hashVersion": 1
                  },
                  "targetType": "feature-rule",
                  "targetId": "<string>"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
```
```

--------------------------------

### Set up GrowthBook OpenFeature provider in C#

Source: https://docs.growthbook.io/lib/openfeature

C# example that creates a GrowthBookProvider with a client key and API host URL, then sets it as the OpenFeature provider and retrieves a client.

```csharp
using GrowthBook.OpenFeature;
using OpenFeature;
using OpenFeature.Model;

var provider = new GrowthBookProvider(
    clientKey: "sdk-abc123",
    apiHostUrl: "https://cdn.growthbook.io"
);

Api.Instance.SetProvider(provider);
var client = Api.Instance.GetClient();
```

--------------------------------

### Run GrowthBook setup skill

Source: https://docs.growthbook.io/integrations/ai-agents/agent-skills

Run the gb-setup skill to configure credentials. It prompts for a PAT or API key (and API URL for self-hosted), validates them, and writes ~/.config/growthbook/.env with chmod 600.

```bash
/growthbook:gb-setup

```

--------------------------------

### Go example for getting a constant revision

Source: https://docs.growthbook.io/api/constant-revisions/operation/getConstantRevision

Go example using the standard net/http package to call the GET /constants-revisions/{key}/{version} endpoint. Replace the placeholder key and version and provide a valid bearer token.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/constants-revisions/{key}/{version}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### GET /v1/learnings/{id} request examples

Source: https://docs.growthbook.io/api/Learnings/operation/getLearning

Example requests for the GET /v1/learnings/{id} endpoint in multiple languages. All require an Authorization header with a Bearer token. The {id} path parameter must be replaced with the learning ID.

```cURL
curl -X GET 'https://api.growthbook.io/api/v1/learnings/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```Python
import requests

url = "https://api.growthbook.io/api/v1/learnings/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```JavaScript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growthbook.io/api/v1/learnings/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growthbook.io/api/v1/learnings/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```Go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growthbook.io/api/v1/learnings/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```Java
HttpResponse<String> response = Unirest.get("https://api.growthbook.io/api/v1/learnings/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```Ruby
require 'uri'
require 'net/http'

url = URI("https://api.growthbook.io/api/v1/learnings/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```
Tokens:
Raw