Projects and teams

TFS 2017 | TFS 2015 | TFS 2013

Note

Looking for REST APIS that support TFS 2018 or later versions? See the Azure DevOps REST API Reference.

A VSTS organization has one or more projects. Each project has one or more teams that contribute to that project.

Project and team resources

Common tasks

Get a list of projects

Get the projects in the organization.

Get a project's source control provider

Get a project's capabilities to see whether it uses Git or TFVC for source control.

Get the teams in a project

  1. Get a list of teams in a project.
  2. Get the members of a team.

Get the project collection

Each project is in a project collection. Right now, a VSTS organization just has one project collection named "DefaultCollection" so you can use that assumption when you call other APIs. You can also look up the collection.

Create a project

Create a project in a VSTS organization. Currently, this is only supported on VSTS, but not on Team Foundation Server.

Update a project

Projects can be updated:

  1. Update the project description or name
  2. The update is asynchronous, so use the returned operation to get the status of the update.

An operation can be in one of the following states:

State Name Explanation
Queued Project update has been queued to run.
InProgress Project update currently being executed.
Succeeded Project update was successfully completed.
Failed Project updated did not succeed.