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
| Field | Required | Type | Description |
|---|---|---|---|
id | Yes | string | Webhook 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
| Field | Type | Description |
|---|---|---|
id | string | — |
signing_secret | string | New signing secret, format whsec_ + standard Base64 text. Returned only in this response |
updated_at | string | — |
request_id | string | Unique identifier of this request; include it when troubleshooting |
Error codes
| HTTP status | Error code | Description |
|---|---|---|
| 404 | 11800005 | failed to reset webhook signing secret |
Is this page helpful?