更新 Webhook

使用 If-Match 更新名称、URL 或启用状态。

Pinhere 项目、Origin、缺陷、私有截图、Webhook、PAT 与 Chrome 扩展 OAuth API；覆盖固定 PontxSpec 中全部 34 个 Endpoint。Hub 提供文档和本地 SDK/CLI，不代理任何请求。

请求

operationId: updateWebhook
服务器: https://pinhere-jasonhzqs-projects.vercel.app/api/v1
认证: pinherePat, websiteSession, extensionOAuth

请求参数

`webhookId`

pathstring必填

Webhook ID.

whk_example

`If-Match`

headerstring必填

必须等于资源 version 对应的 ETag。

`Idempotency-Key`

headerstring

同一账号与 Endpoint 下保留 24 小时；不同请求复用会返回 409。

example-idempotency-key

Body 参数

WebhookUpdateInput必填

Content-Type: application/json

字段: nameurlenabled

响应

`200`

objectapplication/json

Webhook 已更新。

字段: data

`412`

ErrorResponseapplication/json

缺少 If-Match 或版本冲突。

字段: error

`422`

ErrorResponseapplication/json

URL 未通过公网 HTTPS/SSRF 校验。

字段: error

`default`

ErrorResponseapplication/json

标准错误响应。

字段: error

{
  "data": {
    "id": "whk_example",
    "projectId": "prj_example",
    "name": "Issue automation",
    "url": "https://hooks.example.com/pinhere",
    "enabled": true,
    "createdAt": "2026-08-15T08:00:00.000Z",
    "updatedAt": "2026-08-15T08:00:00.000Z",
    "version": 1
  }
}