List teams

curl --request GET \
  --url https://app.launchdarkly.com/api/v2/teams \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.launchdarkly.com/api/v2/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://app.launchdarkly.com/api/v2/teams",
  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: <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"
	"net/http"
	"io"
)

func main() {

	url := "https://app.launchdarkly.com/api/v2/teams"

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

	req.Header.Add("Authorization", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/teams")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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

{
  "items": [
    {
      "description": "Description for this team.",
      "key": "team-key-123abc",
      "name": "Example team",
      "_access": {
        "denied": [
          {
            "action": "<string>",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "<string>"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "<string>"
              ],
              "role_name": "<string>"
            }
          }
        ],
        "allowed": [
          {
            "action": "<string>",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "<string>"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "<string>"
              ],
              "role_name": "<string>"
            }
          }
        ]
      },
      "_creationDate": "1648671956143",
      "_links": {
        "parent": {
          "href": "/api/v2/teams",
          "type": "application/json"
        },
        "roles": {
          "href": "/api/v2/teams/example-team/roles",
          "type": "application/json"
        },
        "self": {
          "href": "/api/v2/teams/example-team",
          "type": "application/json"
        }
      },
      "_lastModified": "1648672446072",
      "_version": 3,
      "_idpSynced": true,
      "roleAttributes": "{\"developerProjectKey\": [\"default\"]}",
      "roles": {
        "totalCount": 1,
        "items": [
          {
            "key": "role-key-123abc",
            "name": "Example role",
            "projects": {
              "totalCount": 1,
              "items": [
                {
                  "_links": {
                    "environments": {
                      "href": "/api/v2/projects/example-project/environments",
                      "type": "application/json"
                    },
                    "self": {
                      "href": "/api/v2/projects/example-project",
                      "type": "application/json"
                    }
                  },
                  "key": "project-key-123abc",
                  "name": "Example project"
                }
              ]
            },
            "appliedOn": "1648672018410"
          }
        ],
        "_links": {
          "self": {
            "href": "/api/v2/teams/example-team/roles?limit=25",
            "type": "application/json"
          }
        }
      },
      "members": {
        "totalCount": 15
      },
      "projects": {
        "totalCount": 1,
        "items": [
          {
            "_links": {
              "environments": {
                "href": "/api/v2/projects/example-project/environments",
                "type": "application/json"
              },
              "self": {
                "href": "/api/v2/projects/example-project",
                "type": "application/json"
              }
            },
            "key": "project-key-123abc",
            "name": "Example project"
          }
        ]
      },
      "maintainers": {
        "totalCount": 1,
        "items": [
          {
            "_id": "569f183514f4432160000007",
            "_links": {
              "self": {
                "href": "/api/v2/members/569f183514f4432160000007",
                "type": "application/json"
              }
            },
            "email": "ariel@acme.com",
            "firstName": "Ariel",
            "lastName": "Flores",
            "role": "reader"
          }
        ],
        "_links": {
          "self": {
            "href": "/api/v2/teams/example-team/maintainers?limit=20",
            "type": "application/json"
          }
        }
      }
    }
  ],
  "_links": {
    "self": {
      "href": "/api/v2/teams?expand=maintainers%2Cmembers%2Croles%2Cprojects&limit=20",
      "type": "application/json"
    }
  },
  "totalCount": 1
}

{
  "code": "unauthorized",
  "message": "Invalid access token"
}

{
  "code": "method_not_allowed",
  "message": "Method not allowed"
}

{
  "code": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}

List teams

Return a list of teams.

By default, this returns the first 20 teams. Page through this list with the limit parameter and by following the first, prev, next, and last links in the _links field that returns. If those links do not appear, the pages they refer to don’t exist. For example, the first and prev links will be missing from the response on the first page, because there is no previous page and you cannot return to the first page when you are already on the first page.

Filtering teams

LaunchDarkly supports the following fields for filters:

query is a string that matches against the teams’ names and keys. It is not case-sensitive.
- A request with query:abc returns teams with the string abc in their name or key.
nomembers is a boolean that filters the list of teams who have 0 members
- A request with nomembers:true returns teams that have 0 members
- A request with nomembers:false returns teams that have 1 or more members

Sorting teams

LaunchDarkly supports the following fields for sorting:

name sorts by team name. It is not case-sensitive.
memberCount sorts by the number of members on the team.

By default, the sort is in ascending order. Use - to sort in descending order. For example, ?sort=name sorts the response by team name in ascending order, and ?sort=-memberCount sorts by member count from largest to smallest. Combine fields with a comma to break ties, for example ?sort=-memberCount,name.

Expanding the teams response

LaunchDarkly supports expanding several fields in the “List teams” response. By default, these fields are not included in the response.

To expand the response, append the expand query parameter and add a comma-separated list with any of the following fields:

members includes the total count of members that belong to the team.
roles includes a paginated list of the custom roles that you have assigned to the team.
roleAttributes includes a list of the role attributes that you have assigned to the team.
projects includes a paginated list of the projects that the team has any write access to.
maintainers includes a paginated list of the maintainers that you have assigned to the team.

For example, expand=members,maintainers includes the members and maintainers fields in the response.

GET

api

teams

List teams

curl --request GET \
  --url https://app.launchdarkly.com/api/v2/teams \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.launchdarkly.com/api/v2/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://app.launchdarkly.com/api/v2/teams",
  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: <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"
	"net/http"
	"io"
)

func main() {

	url := "https://app.launchdarkly.com/api/v2/teams"

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

	req.Header.Add("Authorization", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/teams")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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

{
  "items": [
    {
      "description": "Description for this team.",
      "key": "team-key-123abc",
      "name": "Example team",
      "_access": {
        "denied": [
          {
            "action": "<string>",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "<string>"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "<string>"
              ],
              "role_name": "<string>"
            }
          }
        ],
        "allowed": [
          {
            "action": "<string>",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "<string>"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "<string>"
              ],
              "role_name": "<string>"
            }
          }
        ]
      },
      "_creationDate": "1648671956143",
      "_links": {
        "parent": {
          "href": "/api/v2/teams",
          "type": "application/json"
        },
        "roles": {
          "href": "/api/v2/teams/example-team/roles",
          "type": "application/json"
        },
        "self": {
          "href": "/api/v2/teams/example-team",
          "type": "application/json"
        }
      },
      "_lastModified": "1648672446072",
      "_version": 3,
      "_idpSynced": true,
      "roleAttributes": "{\"developerProjectKey\": [\"default\"]}",
      "roles": {
        "totalCount": 1,
        "items": [
          {
            "key": "role-key-123abc",
            "name": "Example role",
            "projects": {
              "totalCount": 1,
              "items": [
                {
                  "_links": {
                    "environments": {
                      "href": "/api/v2/projects/example-project/environments",
                      "type": "application/json"
                    },
                    "self": {
                      "href": "/api/v2/projects/example-project",
                      "type": "application/json"
                    }
                  },
                  "key": "project-key-123abc",
                  "name": "Example project"
                }
              ]
            },
            "appliedOn": "1648672018410"
          }
        ],
        "_links": {
          "self": {
            "href": "/api/v2/teams/example-team/roles?limit=25",
            "type": "application/json"
          }
        }
      },
      "members": {
        "totalCount": 15
      },
      "projects": {
        "totalCount": 1,
        "items": [
          {
            "_links": {
              "environments": {
                "href": "/api/v2/projects/example-project/environments",
                "type": "application/json"
              },
              "self": {
                "href": "/api/v2/projects/example-project",
                "type": "application/json"
              }
            },
            "key": "project-key-123abc",
            "name": "Example project"
          }
        ]
      },
      "maintainers": {
        "totalCount": 1,
        "items": [
          {
            "_id": "569f183514f4432160000007",
            "_links": {
              "self": {
                "href": "/api/v2/members/569f183514f4432160000007",
                "type": "application/json"
              }
            },
            "email": "ariel@acme.com",
            "firstName": "Ariel",
            "lastName": "Flores",
            "role": "reader"
          }
        ],
        "_links": {
          "self": {
            "href": "/api/v2/teams/example-team/maintainers?limit=20",
            "type": "application/json"
          }
        }
      }
    }
  ],
  "_links": {
    "self": {
      "href": "/api/v2/teams?expand=maintainers%2Cmembers%2Croles%2Cprojects&limit=20",
      "type": "application/json"
    }
  },
  "totalCount": 1
}

{
  "code": "unauthorized",
  "message": "Invalid access token"
}

{
  "code": "method_not_allowed",
  "message": "Method not allowed"
}

{
  "code": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}

Authorizations

Authorization

string

header

required

Query Parameters

limit

integer<int64>

The number of teams to return in the response. Defaults to 20.

offset

integer<int64>

Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and returns the next limit items.

filter

string<string>

A comma-separated list of filters. Each filter is constructed as field:value.

sort

string<string>

A comma-separated list of fields to sort by. Fields are sorted in ascending order by default. Prefix a field with - to sort in descending order. Supported fields: name, memberCount.

expand

string<string>

A comma-separated list of properties that can reveal additional information in the response.

Response

Teams collection response

items

object[]

required

An array of teams

Show child attributes

_links

object

The location and content type of related resources

Show child attributes

Example:

{
  "self": {
    "href": "/api/v2/teams?expand=maintainers%2Cmembers%2Croles%2Cprojects&limit=20",
    "type": "application/json"
  }
}

totalCount

integer

The number of teams

Example:

1