---
title: "Replace the signing secret immediately on every chain, without an overlap period."
method: POST
path: "/push/subscriptions/{subscription_id}/rotate-secret"
tags: ["Subscriptions"]
---

# Replace the signing secret immediately on every chain, without an overlap period.

`POST /push/subscriptions/{subscription_id}/rotate-secret`

## Request

- Base URL: `https://api.blockvectra.com/v1`
- URL: `https://api.blockvectra.com/v1/push/subscriptions/{subscription_id}/rotate-secret`
- Auth: API key in header `x-api-key`

No request body. The new secret is shown once; an in-flight request may still carry the old signature.

## Response `200`

New signing secret.

- RotateSecretResult
  - `secret` string, required: Shown once

## Other responses

- `default`: Error envelope; the codes, statuses and retry rules are in root x-push-errors. 429 and 503 carry Retry-After.

---

[API](https://skmtc.dev/blockvectra/apis/blockvectra-push-api.md) · [All operations](https://skmtc.dev/blockvectra/apis/blockvectra-push-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockvectra/apis/blockvectra-push-api/revisions/396dd7621c54?raw)