Reference

Endpoint Get List of Teams


Name

get_teams

Description

Gets a list of teams in the default project within the organization. [API reference]

Related Tables

Teams

Parameters

Parameter Required Options
Name: Project

Label: Project Name

The Name of the project.
YES

Output Columns

Label Data Type (SSIS) Data Type (SQL) Length Description
Id DT_WSTR nvarchar(200) 200
Name DT_WSTR nvarchar(200) 200
ProjectId DT_WSTR nvarchar(200) 200
ProjectName DT_WSTR nvarchar(200) 200
Url DT_WSTR nvarchar(2048) 2048
Description DT_WSTR nvarchar(4000) 4000
IdentityUrl DT_WSTR nvarchar(2048) 2048
If the column you are looking for is missing, consider customizing Azure DevOps Connector.

Input Columns

Label Data Type (SSIS) Data Type (SQL) Length Description
There are no Static columns defined for this endpoint. This endpoint detects columns dynamically at runtime.

Examples

SSIS

Use Azure DevOps Connector in API Source or in API Destination SSIS Data Flow components to read or write data.

API Source

This Endpoint belongs to the Teams table, therefore it is better to use it, instead of accessing the endpoint directly:

API Source - Azure DevOps
Read and write Azure DevOps (Cloud or On-Premises) data effortlessly. Integrate, manage, and automate work items, projects, and teams — almost no coding required.
Azure DevOps
Teams
Required Parameters
Project Name Fill-in the parameter...
SSIS API Source - Read from table or endpoint

API Destination

This Endpoint belongs to the Teams table, therefore it is better to use it, instead of accessing the endpoint directly. Use this table and table-operation pair to get list of teams:

API Destination - Azure DevOps
Read and write Azure DevOps (Cloud or On-Premises) data effortlessly. Integrate, manage, and automate work items, projects, and teams — almost no coding required.
Azure DevOps
Teams
Select
Required Parameters
Project Name Fill-in the parameter...
SSIS API Destination - Access table operation

ODBC application

Use these SQL queries in your ODBC application data source:

List teams (default project)

<p>Returns all teams in the default project from the connection. Use this to discover team names and IDs for use in queries or when creating work items. Columns include Id, Name, ProjectId, ProjectName, Url, and Description.</p>

SELECT * FROM Teams

List teams for a project

<p>Returns all teams in a specific project by passing the project ID (or name) in the WITH clause. Use when the default project is not the one you need or when you are iterating over multiple projects.</p>

SELECT * FROM Teams WITH (Project='841e1641-325d-49b1-9c5e-22c11a61d4c4')

List teams (specific columns)

<p>Returns teams with only the columns you select (e.g. Id, Name, ProjectId, ProjectName, Url, Description, IdentityUrl). Use this to keep result sets small or to build pickers and reports that need a subset of team fields.</p>

SELECT Id, Name, ProjectId, ProjectName, Url, Description, IdentityUrl FROM Teams

get_teams endpoint belongs to Teams table(s), and can therefore be used via those table(s).

SQL Server

Use these SQL queries in SQL Server after you create a data source in Data Gateway:

List teams (default project)

<p>Returns all teams in the default project from the connection. Use this to discover team names and IDs for use in queries or when creating work items. Columns include Id, Name, ProjectId, ProjectName, Url, and Description.</p>

DECLARE @MyQuery NVARCHAR(MAX) = 'SELECT * FROM Teams';

EXEC (@MyQuery) AT [LS_TO_AZURE_DEVOPS_IN_GATEWAY];

List teams for a project

<p>Returns all teams in a specific project by passing the project ID (or name) in the WITH clause. Use when the default project is not the one you need or when you are iterating over multiple projects.</p>

DECLARE @MyQuery NVARCHAR(MAX) = 'SELECT * FROM Teams WITH (Project=''841e1641-325d-49b1-9c5e-22c11a61d4c4'')';

EXEC (@MyQuery) AT [LS_TO_AZURE_DEVOPS_IN_GATEWAY];

List teams (specific columns)

<p>Returns teams with only the columns you select (e.g. Id, Name, ProjectId, ProjectName, Url, Description, IdentityUrl). Use this to keep result sets small or to build pickers and reports that need a subset of team fields.</p>

DECLARE @MyQuery NVARCHAR(MAX) = 'SELECT Id, Name, ProjectId, ProjectName, Url, Description, IdentityUrl FROM Teams';

EXEC (@MyQuery) AT [LS_TO_AZURE_DEVOPS_IN_GATEWAY];

get_teams endpoint belongs to Teams table(s), and can therefore be used via those table(s).