Reset Webhook Signing Secret

Updated at:

Resets the signing secret of a Webhook. The request body is empty. The new signing secret is returned only in this response. Subsequent deliveries use the reset secret to compute signatures.

Prerequisites

Endpoint and authentication configured. For details, see Overview and authentication.

Endpoint

POST /webhook_endpoints/{id}/reset_secret

Path parameters

FieldRequiredTypeDescription
idYesstringWebhook ID, format wep_<ULID>

Request example

curl -X POST "$AGENTSTUDIO_URL/webhook_endpoints/wep_01JXX7YQGPRPV1BZXA35QE7WDP/reset_secret" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response

{
  "id": "wep_01JXX7YQGPRPV1BZXA35QE7WDP",
  "signing_secret": "whsec_new_xxx",
  "updated_at": "2026-08-06T10:35:00Z",
  "request_id": "8e1d16e4"
}

Response fields

FieldTypeDescription
idstring—
signing_secretstringNew signing secret, format whsec_ + standard Base64 text. Returned only in this response
updated_atstring—
request_idstringUnique identifier of this request; include it when troubleshooting

Error codes

HTTP statusError codeDescription
40411800005failed to reset webhook signing secret