# Revoke Link Token API

- Anchor: `bankhub-en-api-link-token-thu-hoi-link-token`
- URL: https://developer.sepay.vn/en/bankhub/api/link-token/thu-hoi-link-token.md
- Description: API to revoke a previously created link token. Once revoked, the link token can no longer be used to access the WebView.

**POST** `https://bankhub-api-sandbox.sepay.vn/v1/link-token/revoke`
```http
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
```



**Request Body**

<!-- Params table -->

**Headers**

<!-- Params table -->

> **Note** (info)
>
>
> * This API requires a Bearer Token in the Authorization header
> * Once revoked, the link token can no longer be used
> * Any user currently accessing that link token will be disconnected
>

| Code | Name | Description |
|------|------|-------------|
| 404 | Not Found | The link token does not exist or does not belong to this merchant |
| 401 | Unauthorized | Invalid or expired access token |
| 400 | Validation Error | Invalid link_token_xid (wrong format or missing) |







**RESPONSE 200 - Revoked Successfully**


```json
{
  "message": "The link has been revoked successfully"
}
```





**RESPONSE 404 - Link Token Not Found**


```json
{
  "code": 404,
  "message": "The link token does not exist or does not belong to this merchant"
}
```








---

> **Important Notes** (warn)
>
>
> * Revocation is irreversible. A revoked link token cannot be restored
> * Any user currently using the link token will be disconnected immediately
> * If the link token was already revoked previously, the API still returns 404
> * It is recommended to revoke the link token immediately when suspicious activity is detected or the user cancels
>

---