> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/networking/sdn/cloud-router/destroycloudrouter.md).

# DestroyCloudRouter

## 1. API Description

This API (DestroyCloudRouter) is used to destroy Cloud Router

{% hint style="info" %}
**Notes**

* This operation is irreversible. Once successful, the Cloud Router will be permanently released -- proceed with caution.
* This API can only be called to permanently destroy a Cloud Router that is in **RECYCLED** status (i.e. after being deleted via [DeleteCloudRouter](https://github.com/zenlayer/zenlayercloud-api-doc-en/tree/main/sdn/cloud-router/delete-cloud-router.md)).
* This is an asynchronous API. After the destroy request is successfully submitted, the destroy operation is not completed immediately. During this period the Cloud Router status will be **`DESTROYING`**. Once destroyed successfully, information about the Cloud Router can no longer be queried.
  {% endhint %}

## 2. Input Parameters

The following request parameter list only provides API request parameters.

| Parameter Name | Required | Type   | Description      |
| -------------- | -------- | ------ | ---------------- |
| cloudRouterId  | Yes      | String | Cloud Router ID. |

## 3. Output Parameters

| Parameter Name | Type   | Description                                                                                                           |
| -------------- | ------ | --------------------------------------------------------------------------------------------------------------------- |
| requestId      | String | <p>The unique request ID, which is returned for each request.</p><p>RequestId is required for locating a problem.</p> |

## 4. Code Example

{% tabs %}
{% tab title="Example" %}
**1. Destroy a Cloud Router.**

```json
POST /api/v2/sdn HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DestroyCloudRouter
<Common Request Params>

Request:
{
    "cloudRouterId": "your-cloud-router-id"
}

Response:
{   
  "requestId": "T98044459-95B2-477E-9A2F-00253A70CC6E",
  "response": {
     "requestId": "T98044459-95B2-477E-9A2F-00253A70CC6E"
  }
}
```

{% endtab %}
{% endtabs %}

## 5. Developer Resources

Zenlayer Cloud API 2.0 integrates [SDKs](/api-reference/api-introduction/toolkit/api-sdk.md)，to make it easier for you to call APIs. More programming languages will be supported.

## 6. Error Codes

The following only lists the error codes related to the API business logic. For other error codes, see [Common Error Codes](/api-reference/api-introduction/instruction/commonerrorcode.md).

| HTTP Status Code | Error Code              | Description                          |
| ---------------- | ----------------------- | ------------------------------------ |
| 403              | OPERATION\_NOT\_SUPPORT | This operation is not yet supported. |