> For the complete documentation index, see [llms.txt](https://tri.gitbook.io/tri-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tri.gitbook.io/tri-doc/triangle-registry/retire.md).

# Retire

### Triangle Registry - Retire

<mark style="color:green;">`POST`</mark> <https://sandbox.triangle.digital/api/v2/triangle\\_registry/:mint\\_id/retire>

**Headers**

<table data-full-width="true"><thead><tr><th>Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr></tbody></table>

**Body**

<table data-full-width="true"><thead><tr><th width="131">Name</th><th width="149">Type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>hash</code></td><td>string</td><td>API key</td><td>fk5f0iuy-rr06-j4x3-i75b-fy2s67s4ilo1</td></tr><tr><td><code>qty</code></td><td>float</td><td>Quantity of tokens to retire *</td><td>20.1402</td></tr><tr><td><code>month</code></td><td>integer</td><td>Month number (1-12)</td><td>11</td></tr><tr><td><code>year</code></td><td>integer</td><td>Year</td><td>2025</td></tr></tbody></table>

**Frozen asset**

An asset frozen by a Triangle Admin (Deal Status `Frozen`) cannot be retired. The call answers HTTP 400 with `code` = `asset_frozen` and an error on `mint_id`; nothing is retired. Contact Triangle Admin to have the asset unfrozen.

**Response**

{% tabs %}
{% tab title="200" %}

<pre class="language-json" data-full-width="false"><code class="lang-json"><strong>{
</strong>  "message": "The specified quantity was successfully retired."
  "success": true,
  "data": {}
  "operations_count": 1
}
</code></pre>

{% endtab %}

{% tab title="400" %}

```json
{
  "message": "Error! No such hash.",
  "success": false,
}
```

{% endtab %}

{% tab title="400 Frozen asset" %}

```json
{
  "message": "The specified quantity was not retired.",
  "success": false,
  "data": {
    "errors": {
      "mint_id": ["asset is frozen, please, contact Triangle Admin"]
    }
  },
  "operations_count": 1,
  "code": "asset_frozen"
}
```

{% endtab %}
{% endtabs %}