---
title: "DELETE /widgets/{widgetName}"
method: DELETE
path: "/widgets/{widgetName}"
---

# DELETE /widgets/{widgetName}

`DELETE /widgets/{widgetName}`

Delete a Widget asynchronously.

## Path parameters

- `widgetName` string, required

## Query parameters

- `api-version` string, required

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

- object — Provides status details for long running operations.
  - `id` string, required — The unique ID of the operation.
  - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' | 'Canceled', required — Enum describing allowed operation states.
  - `error` AzureCoreFoundationsError — The error object.
    - `code` string, required — One of a server-defined set of error codes.
    - `message` string, required — A human-readable representation of the error.
    - `target` string — The target of the error.
    - `details` AzureCoreFoundationsError[] — An array of details about specific errors that led to this reported error.
    - `innererror` AzureCoreFoundationsInnerError — An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
      - `code` string — One of a server-defined set of error codes.
      - `innererror` AzureCoreFoundationsInnerError — recursive

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/contosowidgetmanager-azure-contoso-widgetmanager.md) · [All operations](https://skmtc.net/azure/apis/contosowidgetmanager-azure-contoso-widgetmanager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/contosowidgetmanager-azure-contoso-widgetmanager/versions/2317506a7480/schema)