---
title: "Revoke Knot Zero Links"
method: POST
path: "/zero-link/revoke"
---

# Revoke Knot Zero Links

`POST /zero-link/revoke`

## Request

- Base URL: `https://development.knotapi.com`
- URL: `https://development.knotapi.com/zero-link/revoke`
- Auth: HTTP basic

Revoke a user's Knot Zero links.

## Request body

- object
  - `external_user_id` string, required: Your unique identifier for the user.
  - `card_id` string: Your unique identifier for the card. If omitted, all of the user's links are revoked.

## Response `200`

Successful request.

- object
  - `revoked` integer: The number of links revoked. `0` if the user had no active links.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized request.
- `403`: Forbidden request.
- `429`: Too many requests. Limited to 600 requests per minute per client.

## Changes

- **2026-11-03** `f10ecfa12c00`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/knotapi/apis/knot-api/changes/zero-link/revoke/post.md)

---

[API](https://skmtc.dev/knotapi/apis/knot-api.md) - [All operations](https://skmtc.dev/knotapi/apis/knot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knotapi/apis/knot-api/revisions/f10ecfa12c00?raw)