Projects - Create

Service:

Core

API Version:

6.0

Queues a project to be created. Use the GetOperation to periodically check for create project status.

POST https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

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 '6.0' to use this version of the api.

Request Body

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 (uuid)	Project identifier.
lastUpdateTime	string (date-time)	Project last update time.
name	string	Project name.
revision	integer (int64)	Project revision.
state	ProjectState	Project state.
url	string	Url to the full version of the object.
visibility	ProjectVisibility	Project visibility.

Responses

Name	Type	Description
200 OK	OperationReference	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_manage	Grants the ability to create, read, update, and delete projects and teams.

Examples

Sample request

HTTP

POST https://dev.azure.com/fabrikam/_apis/projects?api-version=6.0

{
  "name": "FabrikamTravel",
  "description": "Frabrikam travel app for Windows Phone",
  "capabilities": {
    "versioncontrol": {
      "sourceControlType": "Git"
    },
    "processTemplate": {
      "templateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45"
    }
  }
}

Sample response

Status code:

202

{
  "id": "066488b8-b14e-43d1-befc-a2e655266e2b",
  "status": "queued",
  "url": "https://dev.azure.com/fabrikam/_apis/operations/066488b8-b14e-43d1-befc-a2e655266e2b"
}

Definitions

Name	Description
OperationReference	Reference for an async operation.
OperationStatus	The current status of the operation.
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

OperationReference

Object

Reference for an async operation.

Name	Type	Description
id	string (uuid)	Unique identifier for the operation.
pluginId	string (uuid)	Unique identifier for the plugin.
status	OperationStatus	The current status of the operation.
url	string	URL to get the full operation object.

OperationStatus

Enumeration

The current status of the operation.

Value	Description
cancelled	The operation was cancelled by the user.
failed	The operation completed with a failure.
inProgress	The operation is in progress.
notSet	The operation does not have a status set.
queued	The operation has been queued.
succeeded	The operation completed successfully.

ProjectState

Enumeration

The current state of the project.

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

ProjectVisibility

Enumeration

Indicates whom the project is visible to.

Value	Description
private	The project is only visible to users with explicit access.
public	The project is visible to all.

ReferenceLinks

Object

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

Object

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 (uuid)	Project identifier.
lastUpdateTime	string (date-time)	Project last update time.
name	string	Project name.
revision	integer (int64)	Project revision.
state	ProjectState	Project state.
url	string	Url to the full version of the object.
visibility	ProjectVisibility	Project visibility.

WebApiTeamRef

Object

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