Share via

Workspaces - Delete

Service:
Databricks
API Version:
2026-01-01

Deletes the workspace.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}?api-version=2026-01-01
With optional parameters: 
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}?api-version=2026-01-01&forceDeletion={forceDeletion}

URI Parameters

Name In Required Type Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

The name of the resource group. The name is case insensitive.
subscriptionId
 path True

string (uuid)

The ID of the target subscription. The value must be an UUID.
workspaceName
 path True

string

minLength: 3
maxLength: 64

The name of the workspace.
api-version
 query True

string

minLength: 1

The API version to use for this operation.
forceDeletion
 query

boolean

Optional parameter to retain default unity catalog data. By default the data will retained if Uc is enabled on the workspace.

Responses

Name Type Description
200 OK

OK. The request has succeeded.
202 Accepted

Accepted - Returns this status until the asynchronous operation has completed.
204 No Content

NoContent
Other Status Codes

ErrorResponse

Error response describing why the operation failed.

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 a workspace
Delete a workspace with forceDeletion parameter

Delete a workspace

Sample request

DELETE https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01

Sample response

Status code:
200
Status code:
202 
Retry-After: 10
Azure-AsyncOperation: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/HelloWorld/providers/Microsoft.Databricks/workspaces/swaggerExample/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-01-01
Location: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/HelloWorld/providers/Microsoft.Databricks/workspaces/swaggerExample/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-01-01
Status code:
204

Delete a workspace with forceDeletion parameter

Sample request

DELETE https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01&forceDeletion=false

Sample response

Status code:
200
Status code:
202 
Retry-After: 10
Azure-AsyncOperation: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/HelloWorld/providers/Microsoft.Databricks/workspaces/swaggerExample/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-01-01
Location: /subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/HelloWorld/providers/Microsoft.Databricks/workspaces/swaggerExample/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-01-01
Status code:
204

Definitions

Name Description
ErrorDetail

Error details.
ErrorInfo

The code and message for an error.
ErrorResponse

Error response.

ErrorDetail

Object

Error details.

Name Type Description
code

string

The error's code.
message

string

A human readable error message.
target

string

Indicates which property in the request is responsible for the error.

ErrorInfo

Object

The code and message for an error.

Name Type Description
code

string

A machine readable error code.
details

ErrorDetail[]

error details.
innererror

string

Inner error details if they exist.
message

string

A human readable error message.

ErrorResponse

Object

Error response.

Name Type Description
error

ErrorInfo

The code and message for an error.
The error details.