Create a single team

POST /teams

cURL

cURL

curl -X POST https://api.growthbook.io/api/v1/teams -d '{ ... }' -u secret_abc123DEF456

200

{
  "team": {
    "id": "<string>",
    "dateCreated": "2023-11-07T05:31:56Z",
    "dateUpdated": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "createdBy": "<string>",
    "description": "<string>",
    "role": "<string>",
    "limitAccessByEnvironment": true,
    "environments": [
      "<string>"
    ],
    "members": [
      "<string>"
    ],
    "managedByIdp": true,
    "projectRoles": [
      {
        "role": "<string>",
        "limitAccessByEnvironment": true,
        "environments": [
          "<string>"
        ],
        "project": "<string>",
        "teams": [
          "<string>"
        ]
      }
    ],
    "managedBy": {
      "type": "<string>",
      "resourceId": "<string>"
    },
    "defaultProject": "<string>"
  }
}

Authorizations

bearerAuthbasicAuth

Authorization · string · header · required

If using Bearer auth, pass the Secret Key as the token:

curl https://api.growthbook.io/api/v1 \
  -H "Authorization: Bearer secret_abc123DEF456"

Body

application/json

name · string · required

description · string · required

role · string · required

The global role for members of this team

createdBy · string

limitAccessByEnvironment · boolean

environments · string[]

An empty array means 'all environments'

projectRoles · object[]

Show child attributes

managedBy · object

Show child attributes

defaultProject · string

Response

200 - application/json

Success

team · object · required

Show child attributes