---
title: "Rotate a webhook's signing secret."
method: POST
path: "/api/Webhooks/{id}/rotate-secret"
tags: ["Webhooks"]
---

# Rotate a webhook's signing secret.

`POST /api/Webhooks/{id}/rotate-secret`

## Request

- Base URL: `https://api.3dprintlog.com`
- URL: `https://api.3dprintlog.com/api/Webhooks/{id}/rotate-secret`
- Auth: OAuth 2 (authorization code, authorization URL `https://3dprintlog.auth0.com/authorize`, token URL `https://3dprintlog.auth0.com/oauth/token`)

Returns the new secret once. The old one stops signing at once.

## Path parameters

- `id` string, uuid, required

## Response `200`

The webhook, with its new secret.

- PrintLogApiModelsDTOsWebhookWebhookSubscriptionCreatedDto: A new subscription, or one whose secret was just rotated: the only responses that carry the signing secret. It cannot be shown again; rotate it to get a new one.
  - `id` string, uuid
  - `url` string, nullable
  - `description` string, nullable
  - `events` string[], nullable: `print.started`, `print.finished` and/or `print.failed`.
  - `enabled` boolean
  - `consecutiveFailures` integer: Deliveries in a row that failed after their retries.
  - `lastDeliveryAt` string, date-time, nullable
  - `lastStatusCode` integer, nullable: The HTTP status of the last delivery, or null when no response came back.
  - `lastDeliveryResult` string, nullable: `success`, `http_error`, `timeout`, `connection_failed` or `blocked_address`; null before the first delivery.
  - `autoDisabledAt` string, date-time, nullable: When repeated failures turned it off; turning it back on clears this.
  - `createdDate` string, date-time
  - `updatedDate` string, date-time
  - `secret` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: The webhook is not yours.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/3dprintlog/apis/3d-print-log-api.md) · [All operations](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/llms.txt) · [OpenAPI document](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/revisions/dfc3a4df4e38?raw)