Create Team

curl --request POST \
  --url https://statsigapi.net/console/v1/users/teams \
  --header 'Content-Type: application/json' \
  --header 'STATSIG-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "members": [
    "<string>"
  ],
  "admins": [
    "<string>"
  ],
  "defaultGateMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultExperimentPrimaryMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultExperimentSecondaryMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultHoldoutMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultTargetApplications": [
    "<string>"
  ],
  "description": "<string>",
  "defaultHoldoutID": "<string>",
  "requireReviews": true,
  "requireGateTemplates": true,
  "requireExperimentTemplates": true,
  "requireDynamicConfigTemplates": true
}
'

import requests

url = "https://statsigapi.net/console/v1/users/teams"

payload = {
    "name": "<string>",
    "members": ["<string>"],
    "admins": ["<string>"],
    "defaultGateMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultExperimentPrimaryMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultExperimentSecondaryMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultHoldoutMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultTargetApplications": ["<string>"],
    "description": "<string>",
    "defaultHoldoutID": "<string>",
    "requireReviews": True,
    "requireGateTemplates": True,
    "requireExperimentTemplates": True,
    "requireDynamicConfigTemplates": True
}
headers = {
    "STATSIG-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'STATSIG-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    members: ['<string>'],
    admins: ['<string>'],
    defaultGateMetrics: [{name: '<string>', type: '<string>'}],
    defaultExperimentPrimaryMetrics: [{name: '<string>', type: '<string>'}],
    defaultExperimentSecondaryMetrics: [{name: '<string>', type: '<string>'}],
    defaultHoldoutMetrics: [{name: '<string>', type: '<string>'}],
    defaultTargetApplications: ['<string>'],
    description: '<string>',
    defaultHoldoutID: '<string>',
    requireReviews: true,
    requireGateTemplates: true,
    requireExperimentTemplates: true,
    requireDynamicConfigTemplates: true
  })
};

fetch('https://statsigapi.net/console/v1/users/teams', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://statsigapi.net/console/v1/users/teams",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'members' => [
        '<string>'
    ],
    'admins' => [
        '<string>'
    ],
    'defaultGateMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultExperimentPrimaryMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultExperimentSecondaryMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultHoldoutMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultTargetApplications' => [
        '<string>'
    ],
    'description' => '<string>',
    'defaultHoldoutID' => '<string>',
    'requireReviews' => true,
    'requireGateTemplates' => true,
    'requireExperimentTemplates' => true,
    'requireDynamicConfigTemplates' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "STATSIG-API-KEY: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://statsigapi.net/console/v1/users/teams"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"members\": [\n    \"<string>\"\n  ],\n  \"admins\": [\n    \"<string>\"\n  ],\n  \"defaultGateMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentPrimaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentSecondaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultHoldoutMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultTargetApplications\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"defaultHoldoutID\": \"<string>\",\n  \"requireReviews\": true,\n  \"requireGateTemplates\": true,\n  \"requireExperimentTemplates\": true,\n  \"requireDynamicConfigTemplates\": true\n}")

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

	req.Header.Add("STATSIG-API-KEY", "<api-key>")
	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))

}

HttpResponse<String> response = Unirest.post("https://statsigapi.net/console/v1/users/teams")
  .header("STATSIG-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"members\": [\n    \"<string>\"\n  ],\n  \"admins\": [\n    \"<string>\"\n  ],\n  \"defaultGateMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentPrimaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentSecondaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultHoldoutMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultTargetApplications\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"defaultHoldoutID\": \"<string>\",\n  \"requireReviews\": true,\n  \"requireGateTemplates\": true,\n  \"requireExperimentTemplates\": true,\n  \"requireDynamicConfigTemplates\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://statsigapi.net/console/v1/users/teams")

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

request = Net::HTTP::Post.new(url)
request["STATSIG-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"members\": [\n    \"<string>\"\n  ],\n  \"admins\": [\n    \"<string>\"\n  ],\n  \"defaultGateMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentPrimaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentSecondaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultHoldoutMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultTargetApplications\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"defaultHoldoutID\": \"<string>\",\n  \"requireReviews\": true,\n  \"requireGateTemplates\": true,\n  \"requireExperimentTemplates\": true,\n  \"requireDynamicConfigTemplates\": true\n}"

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

{
  "message": "Team created successfully.",
  "data": {
    "name": "The Avengers",
    "members": [
      {
        "email": "test@statsig.com",
        "firstName": "test",
        "lastName": "user",
        "role": "admin"
      }
    ],
    "admins": [],
    "defaultGateMetrics": [],
    "defaultExperimentPrimaryMetrics": [],
    "defaultExperimentSecondaryMetrics": [],
    "defaultHoldoutMetrics": [],
    "changeTeamConfigs": "anyone",
    "reviewApproval": "anyone",
    "defaultTargetApplications": []
  }
}

{
  "status": 400,
  "message": "Invalid request. Please check the request input and try again."
}

{
  "status": 401,
  "message": "This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx"
}

POST

console

users

teams

Create Team

curl --request POST \
  --url https://statsigapi.net/console/v1/users/teams \
  --header 'Content-Type: application/json' \
  --header 'STATSIG-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "members": [
    "<string>"
  ],
  "admins": [
    "<string>"
  ],
  "defaultGateMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultExperimentPrimaryMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultExperimentSecondaryMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultHoldoutMetrics": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "defaultTargetApplications": [
    "<string>"
  ],
  "description": "<string>",
  "defaultHoldoutID": "<string>",
  "requireReviews": true,
  "requireGateTemplates": true,
  "requireExperimentTemplates": true,
  "requireDynamicConfigTemplates": true
}
'

import requests

url = "https://statsigapi.net/console/v1/users/teams"

payload = {
    "name": "<string>",
    "members": ["<string>"],
    "admins": ["<string>"],
    "defaultGateMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultExperimentPrimaryMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultExperimentSecondaryMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultHoldoutMetrics": [
        {
            "name": "<string>",
            "type": "<string>"
        }
    ],
    "defaultTargetApplications": ["<string>"],
    "description": "<string>",
    "defaultHoldoutID": "<string>",
    "requireReviews": True,
    "requireGateTemplates": True,
    "requireExperimentTemplates": True,
    "requireDynamicConfigTemplates": True
}
headers = {
    "STATSIG-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'STATSIG-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    members: ['<string>'],
    admins: ['<string>'],
    defaultGateMetrics: [{name: '<string>', type: '<string>'}],
    defaultExperimentPrimaryMetrics: [{name: '<string>', type: '<string>'}],
    defaultExperimentSecondaryMetrics: [{name: '<string>', type: '<string>'}],
    defaultHoldoutMetrics: [{name: '<string>', type: '<string>'}],
    defaultTargetApplications: ['<string>'],
    description: '<string>',
    defaultHoldoutID: '<string>',
    requireReviews: true,
    requireGateTemplates: true,
    requireExperimentTemplates: true,
    requireDynamicConfigTemplates: true
  })
};

fetch('https://statsigapi.net/console/v1/users/teams', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://statsigapi.net/console/v1/users/teams",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'members' => [
        '<string>'
    ],
    'admins' => [
        '<string>'
    ],
    'defaultGateMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultExperimentPrimaryMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultExperimentSecondaryMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultHoldoutMetrics' => [
        [
                'name' => '<string>',
                'type' => '<string>'
        ]
    ],
    'defaultTargetApplications' => [
        '<string>'
    ],
    'description' => '<string>',
    'defaultHoldoutID' => '<string>',
    'requireReviews' => true,
    'requireGateTemplates' => true,
    'requireExperimentTemplates' => true,
    'requireDynamicConfigTemplates' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "STATSIG-API-KEY: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://statsigapi.net/console/v1/users/teams"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"members\": [\n    \"<string>\"\n  ],\n  \"admins\": [\n    \"<string>\"\n  ],\n  \"defaultGateMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentPrimaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentSecondaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultHoldoutMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultTargetApplications\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"defaultHoldoutID\": \"<string>\",\n  \"requireReviews\": true,\n  \"requireGateTemplates\": true,\n  \"requireExperimentTemplates\": true,\n  \"requireDynamicConfigTemplates\": true\n}")

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

	req.Header.Add("STATSIG-API-KEY", "<api-key>")
	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))

}

HttpResponse<String> response = Unirest.post("https://statsigapi.net/console/v1/users/teams")
  .header("STATSIG-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"members\": [\n    \"<string>\"\n  ],\n  \"admins\": [\n    \"<string>\"\n  ],\n  \"defaultGateMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentPrimaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentSecondaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultHoldoutMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultTargetApplications\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"defaultHoldoutID\": \"<string>\",\n  \"requireReviews\": true,\n  \"requireGateTemplates\": true,\n  \"requireExperimentTemplates\": true,\n  \"requireDynamicConfigTemplates\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://statsigapi.net/console/v1/users/teams")

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

request = Net::HTTP::Post.new(url)
request["STATSIG-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"members\": [\n    \"<string>\"\n  ],\n  \"admins\": [\n    \"<string>\"\n  ],\n  \"defaultGateMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentPrimaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultExperimentSecondaryMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultHoldoutMetrics\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"defaultTargetApplications\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"defaultHoldoutID\": \"<string>\",\n  \"requireReviews\": true,\n  \"requireGateTemplates\": true,\n  \"requireExperimentTemplates\": true,\n  \"requireDynamicConfigTemplates\": true\n}"

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

{
  "message": "Team created successfully.",
  "data": {
    "name": "The Avengers",
    "members": [
      {
        "email": "test@statsig.com",
        "firstName": "test",
        "lastName": "user",
        "role": "admin"
      }
    ],
    "admins": [],
    "defaultGateMetrics": [],
    "defaultExperimentPrimaryMetrics": [],
    "defaultExperimentSecondaryMetrics": [],
    "defaultHoldoutMetrics": [],
    "changeTeamConfigs": "anyone",
    "reviewApproval": "anyone",
    "defaultTargetApplications": []
  }
}

{
  "status": 400,
  "message": "Invalid request. Please check the request input and try again."
}

{
  "status": 401,
  "message": "This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx"
}

Authorizations

STATSIG-API-KEY

string

header

required

Headers

x-respect-review-settings

string

Optional header to respect review settings for mutation endpoints.

Body

application/json

name

string

required

The name of the team.

members

string[]

required

Array of member email addresses in the team.

admins

string[]

required

Array of admin email addresses in the team.

defaultGateMetrics

object[]

required

Default gate metrics for the team.

Show child attributes

defaultExperimentPrimaryMetrics

object[]

required

Default primary metrics for experiments in the team.

Show child attributes

defaultExperimentSecondaryMetrics

object[]

required

Default secondary metrics for experiments in the team.

Show child attributes

defaultHoldoutMetrics

object[]

required

Default holdout metrics for the team.

Show child attributes

changeTeamConfigs

enum<string>

required

Who can change team configurations: "anyone" or "team_only".

Available options:

anyone,

team_only

reviewApproval

enum<string>

required

Who can review and approve changes: "anyone", "team_only", or "admin_only".

Available options:

anyone,

team_only,

admin_only

defaultTargetApplications

string[]

required

Default target applications for the team.

description

string

Description of the team.

defaultHoldoutID

string | null

Default holdout ID for the team, if applicable.

requireReviews

boolean | null

Whether reviews are required for changes, if applicable.

requireGateTemplates

boolean | null

Whether gate templates are required for the team, if applicable.

requireExperimentTemplates

boolean | null

Whether experiment templates are required for the team, if applicable.

requireDynamicConfigTemplates

boolean | null

Whether dynamic config templates are required for the team, if applicable.

Response

Create team response

message

string

required

A simple string explaining the result of the operation.

data

object

required

A single result.

Show child attributes

⌘I

HTTP API

Console API

Alerts

Audit Logs

Autotunes

Company

Dynamic Configs

Events

Experiments

Experiments (Warehouse Native)

Configs

Gates

Holdouts

Ingestions

Keys

Layers

Metrics

Metrics (Warehouse Native)

Project

Usage

Reports

Segments

Tags

Target App

Users

Create Team

Authorizations

Headers

Body

Response