Create Team

POST /console/v1/users/teams

Create Team

cURL

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>"
    }
  ],
  "changeTeamConfigs": "anyone",
  "reviewApproval": "anyone",
  "defaultTargetApplications": [
    "<string>"
  ],
  "description": "<string>",
  "defaultHoldoutID": "<string>",
  "requireReviews": true,
  "requireGateTemplates": true,
  "requireExperimentTemplates": true,
  "requireDynamicConfigTemplates": true
}
'

200

{
  "message": "Team created successfully.",
  "data": {
    "name": "The Avengers",
    "members": [
      {
        "email": "[e-mail]",
        "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.

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

200

application/json

Create team response

message · string · required

A simple string explaining the result of the operation.

data · object · required

A single result.

Show child attributes