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.
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
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:
- Update the project description or name
- 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. |