Delete Queue

Deletes an existing queue. This operation removes all associated state, including messages in the queue.


Method Request URI HTTP version
DELETE{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Queue Path} HTTP/1.1

Request Headers

The following table describes required and optional request headers.

Request Header Description
Namespace Management Endpoint url
x-ms-version 2012-03-01

Note that the request also requires a client certificate. This certificate must match the certificate you uploaded for that particular subscription.

Request Body



The response includes an HTTP status code and a set of response headers.

Response Codes


If you create a queue with a name that contains special or encoded characters (for example, test?Name=value&, which gets encoded to test%3FName%3Dvalue%26), a (401) Unauthorized exception is generated.

Code Description
200 Queue deleted successfully. This does not mean that the queue is completely deleted upon the return of the API call. It means that it is marked for deletion.
401 Authorization failure.
404 The specified queue does not exist.
500 Internal error.

For information about status codes, see Status and Error Codes.

Response Headers


Response Body