---
title: "Revoke an overlap secret early"
method: DELETE
path: "/api/v2/webhook-secret/{id}"
tags: ["webhook"]
---

# Revoke an overlap secret early

`DELETE /api/v2/webhook-secret/{id}`

## Request

- Base URL: `https://central.zerotier.com`
- URL: `https://central.zerotier.com/api/v2/webhook-secret/{id}`
- Auth: HTTP bearer

Immediately revokes an overlap secret before its grace window expires. The active primary secret (expiryAt null) cannot be deleted — rotate first. Attempting to delete the primary returns 400.

## Path parameters

- `id` string, required

## Response `200`

Secret revoked

- SuccessMessageResponse
  - `message` string, required: Human-readable confirmation message

## Other responses

- `401`: Missing or invalid authentication token
- `403`: Insufficient permissions
- `500`: Internal server error

---

[API](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api.md) - [All operations](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api/revisions/b2e7468ad104?raw)