Projects - Delete

Service:

Core

API Version:

7.1

Queues a project to be deleted. Use the GetOperation to periodically check for delete project status.

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

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
projectId	path	True	string uuid	The project id of the project to delete.
api-version	query	True	string	Version of the API to use. This should be set to '7.1' to use this version of the api.

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.

Definitions

Name	Description
OperationReference	Reference for an async operation.
OperationStatus	The current status of the operation.

OperationReference

Reference for an async operation.

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

OperationStatus

The current status of the operation.

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