---
title: "Changes to Rotate webhook signing secret"
method: POST
path: "/webhooks/{webhookId}/rotate-secret"
---

# Changes to Rotate webhook signing secret

`POST /webhooks/{webhookId}/rotate-secret`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 28 revisions.

- **2026-08-27** `359d267dca88` — 1 info
- **2026-08-23** `b1ad79e918ac` — 1 info
- **2026-08-08** `0bb9c54b1f61` — 1 breaking
- **2026-07-26** `270e233e401c` — 2 warning

## Changes

- **2026-08-27** `359d267dca88` — 1 info
  - deleted the `header` request parameter `X-Agent-ID` with deprecation
- **2026-08-23** `b1ad79e918ac` — 1 info
  - `header` request parameter `X-Agent-ID` was deprecated
- **2026-08-08** `0bb9c54b1f61` — 1 breaking
  - added the pattern `^whk_[0-9a-f]{32}$` to the `path` request parameter `webhookId`
- **2026-07-26** `270e233e401c` — 2 warning
  - for the `header` request parameter `Idempotency-Key`, the maxLength was set to `255`
  - for the `path` request parameter `webhookId`, the maxLength was set to `64`

---

[Operation](https://skmtc.dev/natural/apis/natural-api/docs/webhooks/:webhookId/rotate-secret/post.md) · [API](https://skmtc.dev/natural/apis/natural-api.md) · [Page](https://skmtc.dev/natural/apis/natural-api/changes/webhooks/:webhookId/rotate-secret/post)