Webhook

重置 Signing Secret

重置 Webhook 的 Signing Secret。请求体为空。新的 Signing Secret 只在本次响应返回，后续投递使用重置后的 Secret 重新计算签名。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

POST /webhook_endpoints/{id}/reset_secret

参数	必填	类型	说明
`id`	是	string	Webhook ID，格式 wep_<ULID>

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

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

字段	类型	说明
`id`	string	—
`signing_secret`	string	新的验签密钥，格式 whsec_ 加标准 Base64 文本。仅在本次响应返回
`updated_at`	string	—
`request_id`	string	本次请求的唯一标识，排查问题时附带

状态码	错误码	说明
404	`11800005`	failed to reset webhook signing secret

本页目录