# Deleting an Add-on Instance

#### Function

This API is used to delete an add-on instance.

The URL for add-on management is in the format of https://{clusterid}.Endpoint/uri. In the URL, {clusterid} indicates the cluster ID, and uri indicates the resource path, that is, the path for API access.

#### URI

DELETE /api/v3/addons/{id}?cluster_id={cluster_id}

Table 1 describes the parameters of this API.

Table 1 Parameter description
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
cluster_id | Yes | String | Cluster ID. For details about how to obtain the cluster ID, see How to Obtain Parameters in the API URI.
id | Yes | String | Add-on instance ID. For details about how to obtain the ID, see Table 4.

#### Request

Request parameters:

Table 2 list the request parameters.

Table 2 Parameters in the request header
Parameter | Mandatory | Description
--- | --- | ---
Content-Type | Yes | Message body type (format). Default: application/json
X-Auth-Token | Yes | Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details on how to obtain a user token, see API Usage Guidelines.

Example request:

N/A

#### Response

Response parameters:

N/A

Example response:

    success

#### Status Codes

Table 3 Status codes
Status Code | Description
--- | ---
200 | OK

For the description about error status codes, see Status Code.

Parent topic: Add-on Management