---
title: "Permanently deletes a network token"
method: PATCH
path: "/network-tokens/{network_token_id}/delete"
tags: ["Network Tokens"]
---

# Permanently deletes a network token

`PATCH /network-tokens/{network_token_id}/delete`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/network-tokens/{network_token_id}/delete`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `vault:network-tokens`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/network-tokens/:network_token_id/delete/patch.ts> (a function with typed inputs; its response is checked against the schema)

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p> This endpoint is for permanently deleting a network token.  A network token should be deleted when a payment instrument it is associated with is removed from file or if the security of the token has been compromised.

## Path parameters

- `network_token_id` string, required

## Request body

- NetworkTokensRequestDelete
  - `initiated_by` 'cardholder' | 'token_requestor', required: Who initiated/requested the deletion of the token.
  - `reason` 'fraud' | 'other', required: The reason for deleting the token.

## Response `204`

Ok

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Network token not found
- `422`: Invalid data was sent
- `500`: Internal Server Error
- `502`: Bad Gateway. Error from scheme
- `504`: Timeout while waiting for a scheme response

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)