Projects - Delete

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.