POST
/
console
/
v1
/
users
/
teams
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>",
  "description": "<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>"
    }
  ],
  "changeTeamConfigs": "anyone",
  "reviewApproval": "anyone",
  "defaultTargetApplications": [
    "<string>"
  ],
  "defaultHoldoutID": "<string>",
  "requireReviews": true,
  "requireGateTemplates": true,
  "requireExperimentTemplates": true,
  "requireDynamicConfigTemplates": true
}'
{
  "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": []
  }
}

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.

​
defaultExperimentPrimaryMetrics
object[]
required

Default primary metrics for experiments in the team.

​
defaultExperimentSecondaryMetrics
object[]
required

Default secondary metrics for experiments in the team.

​
defaultHoldoutMetrics
object[]
required

Default holdout metrics for the team.

​
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

200
application/json
Create team response
​
message
string
required

A simple string explaining the result of the operation.

​
data
object
required

A single result.