---
title: "Rotate the webhook signing secret"
method: POST
path: "/v1/account/webhook-secret"
tags: ["Account"]
---

# Rotate the webhook signing secret

`POST /v1/account/webhook-secret`

## Request

- Base URL: `https://api.galleyrender.com`
- URL: `https://api.galleyrender.com/v1/account/webhook-secret`
- Auth: HTTP bearer

Mints a new secret and returns it once. The previous secret stops verifying immediately, so update your handler in the same change.

## Response `200`

Rotated. The new secret is in the body and will not be shown again.

- object
  - `object` 'webhook_secret', required
  - `account` string, required
  - `webhook_secret` string, required
  - `webhook_secret_prefix` string
  - `rotated_at` string, date-time, required
  - `note` string

## Other responses

- `401`: `authentication_error`.

---

[API](https://skmtc.dev/galleyrender/apis/galley-render-api.md) · [All operations](https://skmtc.dev/galleyrender/apis/galley-render-api/llms.txt) · [OpenAPI document](https://skmtc.dev/galleyrender/apis/galley-render-api/revisions/a85d68468cd2?raw)