Teams - Get All Teams

  • Reference
Service:
Core
API Version:
5.0-preview.2

Get a list of all teams.

GET https://dev.azure.com/{organization}/_apis/teams?api-version=5.0-preview.2
With optional parameters: 
GET https://dev.azure.com/{organization}/_apis/teams?$mine={$mine}&$top={$top}&$skip={$skip}&api-version=5.0-preview.2

URI Parameters

Name In Required Type Description
organization
 path True

string

The name of the Azure DevOps organization.
api-version
 query True

string

Version of the API to use. This should be set to '5.0-preview.2' to use this version of the api.
$mine
 query

boolean

If true return all the teams requesting user is member, otherwise return all the teams user has read access
$skip
 query

integer

int32

Number of teams to skip.
$top
 query

integer

int32

Maximum number of teams to return.

Responses

Name Type Description
200 OK

WebApiTeam[]

successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name Description
vso.project Grants the ability to read projects and teams.

Examples

Sample Request

GET https://dev.azure.com/fabrikam/_apis/teams?$mine=True&api-version=5.0-preview.2

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "564e8204-a90b-4432-883b-d4363c6125ca",
      "name": "Quality assurance",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/564e8204-a90b-4432-883b-d4363c6125ca",
      "description": "Testing staff",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/564e8204-a90b-4432-883b-d4363c6125ca"
    },
    {
      "id": "66df9be7-3586-467b-9c5f-425b29afedfd",
      "name": "Fabrikam-Fiber-TFVC Team",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/66df9be7-3586-467b-9c5f-425b29afedfd",
      "description": "The default project team.",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/66df9be7-3586-467b-9c5f-425b29afedfd"
    }
  ],
  "count": 2
}

Definitions

WebApiTeam

Name Type Description
description

string

Team description
id

string

Team (Identity) Guid. A Team Foundation ID.
identityUrl

string

Identity REST API Url to this team
name

string

Team name
projectId

string

projectName

string

url

string

Team REST API Url