---
title: "Changes to Rotate the secret for a webhook subscription"
method: POST
path: "/v1/webhooks/subscriptions/{subscription_id}/secret"
---

# Changes to Rotate the secret for a webhook subscription

`POST /v1/webhooks/subscriptions/{subscription_id}/secret`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 24 revisions.

- **2026-09-30** `47cea4404cf5`: 20 warning
- **2026-09-09** `0696ca936043`: 10 warning
- **2026-06-15** `d6cd79e253a6`: 1 info

## Changes

- **2026-09-30** `47cea4404cf5`: 20 warning
  - added the new `content_too_large` enum value to the `code` response property for the response status `400`
  - added the new `content_too_large` enum value to the `code` response property for the response status `401`
  - added the new `content_too_large` enum value to the `code` response property for the response status `403`
  - added the new `content_too_large` enum value to the `code` response property for the response status `404`
  - added the new `content_too_large` enum value to the `code` response property for the response status `429`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `400`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `401`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `403`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `404`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `429`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `400`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `401`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `403`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `404`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `429`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `400`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `401`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `403`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `404`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `429`
- **2026-09-09** `0696ca936043`: 10 warning
  - added the new `conflict` enum value to the `code` response property for the response status `400`
  - added the new `conflict` enum value to the `code` response property for the response status `401`
  - added the new `conflict` enum value to the `code` response property for the response status `403`
  - added the new `conflict` enum value to the `code` response property for the response status `404`
  - added the new `conflict` enum value to the `code` response property for the response status `429`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `400`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `401`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `403`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `404`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `429`
- **2026-06-15** `d6cd79e253a6`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/yoco/apis/yoco-api/docs/v1/webhooks/subscriptions/:subscription_id/secret/post.md) - [API](https://skmtc.dev/yoco/apis/yoco-api.md) - [Page](https://skmtc.dev/yoco/apis/yoco-api/changes/v1/webhooks/subscriptions/:subscription_id/secret/post)