Web Apps - Delete

Description for Deletes a web, mobile, or API app, or one of the deployment slots.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}?api-version=2024-04-01
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}?deleteMetrics={deleteMetrics}&deleteEmptyServerFarm={deleteEmptyServerFarm}&api-version=2024-04-01

URI Parameters

Name In Required Type Description
name
path True

string

Name of the app to delete.

resourceGroupName
path True

string

Name of the resource group to which the resource belongs.

Regex pattern: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000).

api-version
query True

string

API Version

deleteEmptyServerFarm
query

boolean

Specify false if you want to keep empty App Service plan. By default, empty App Service plan is deleted.

deleteMetrics
query

boolean

If true, web app metrics are also deleted.

Responses

Name Type Description
200 OK

Successfully deleted web app.

204 No Content

Successfully deleted web app.

404 Not Found

Web app not found.

Other Status Codes

DefaultErrorResponse

App Service error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

Delete Web app

Sample request

DELETE https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141?api-version=2024-04-01

Sample response

Definitions

Name Description
DefaultErrorResponse

App Service error response.

Details
Error

Error model.

DefaultErrorResponse

App Service error response.

Name Type Description
error

Error

Error model.

Details

Name Type Description
code

string

Standardized string to programmatically identify the error.

message

string

Detailed error description and debugging information.

target

string

Detailed error description and debugging information.

Error

Error model.

Name Type Description
code

string

Standardized string to programmatically identify the error.

details

Details[]

Detailed errors.

innererror

string

More information to debug error.

message

string

Detailed error description and debugging information.

target

string

Detailed error description and debugging information.