Projects - Get

Service:

Core

API Version:

7.1-preview.4

Get project with the specified id or name, optionally including capabilities.

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}?api-version=7.1-preview.4

With optional parameters:

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}?includeCapabilities={includeCapabilities}&includeHistory={includeHistory}&api-version=7.1-preview.4

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
projectId	path	True	string
api-version	query	True	string	Version of the API to use. This should be set to '7.1-preview.4' to use this version of the api.
includeCapabilities	query		boolean	Include capabilities (such as source control) in the team project result (default: false).
includeHistory	query		boolean	Search within renamed projects (that had such name in the past).

Responses

Name	Type	Description
200 OK	TeamProject	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.profile	Grants the ability to read your profile, accounts, collections, projects, teams, and other top-level organizational artifacts.
vso.project	Grants the ability to read projects and teams.

Definitions

Name	Description
ProjectState	The current state of the project.
ProjectVisibility	Indicates whom the project is visible to.
ReferenceLinks	The class to represent a collection of REST reference links.
TeamProject	Represents a Team Project object.
WebApiTeamRef

ProjectState

The current state of the project.

Name	Type	Description
all	string	All projects regardless of state except Deleted.
createPending	string	Project has been queued for creation, but the process has not yet started.
deleted	string	Project has been deleted.
deleting	string	Project is in the process of being deleted.
new	string	Project is in the process of being created.
unchanged	string	Project has not been changed.
wellFormed	string	Project is completely created and ready to use.

ProjectVisibility

Indicates whom the project is visible to.

Name	Type	Description
private	string	The project is only visible to users with explicit access.
public	string	The project is visible to all.

ReferenceLinks

The class to represent a collection of REST reference links.

Name	Type	Description
links	object	The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

TeamProject

Represents a Team Project object.

Name	Type	Description
_links	ReferenceLinks	The links to other objects related to this object.
abbreviation	string	Project abbreviation.
capabilities	object	Set of capabilities this project has (such as process template & version control).
defaultTeam	WebApiTeamRef	The shallow ref to the default team.
defaultTeamImageUrl	string	Url to default team identity image.
description	string	The project's description (if any).
id	string	Project identifier.
lastUpdateTime	string	Project last update time.
name	string	Project name.
revision	integer	Project revision.
state	ProjectState	Project state.
url	string	Url to the full version of the object.
visibility	ProjectVisibility	Project visibility.

WebApiTeamRef

Name	Type	Description
id	string	Team (Identity) Guid. A Team Foundation ID.
name	string	Team name
url	string	Team REST API Url