> For the complete documentation index, see [llms.txt](https://docs.guardianservice.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guardianservice.app/technical-information/tokens/token-retirement-contract/retirement-apis/retiring-tokens.md).

# Retiring Tokens

## Retire tokens.

<mark style="color:green;">`POST`</mark> `/contracts/retire/pools/{poolId}/retire`

Retire tokens.

#### Path Parameters

| Name   | Type   | Description     |
| ------ | ------ | --------------- |
| poolId | String | Pool Identifier |

{% tabs %}
{% tab title="200: OK Successful Operation" %}

```
content:
            application/json:
              schema:
                type: boolean
```

{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}

{% endtab %}

{% tab title="403: Forbidden Forbidden" %}

{% endtab %}

{% tab title="500: Internal Server Error Internal Server Error" %}

```
 content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorDTO'
```

{% endtab %}
{% endtabs %}