Delete Subscription

Deletes an existing subscription.


Method Request URI HTTP version
DELETE{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Topics/Subscriptions/{Subscription Name} 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 topic 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 Subscription deleted successfully.
401 Authorization failure.
404 The specified subscription does not exist.
500 Internal error.

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

Response Headers


Response Body