# Webhooks API
SUMMARY: 为记忆、聊天和任务事件注册 HTTP 回调 — 数据变化时收到通知。

KEY CONTEXT:
Auth: Mind Key
Register: POST /webhooks { url, events, secret? }
List: GET /webhooks
Get: GET /webhooks/:id
Update: PUT /webhooks/:id { url?, events?, secret?, enabled? }
Delete: DELETE /webhooks/:id
Events: memory.*, memory.store, memory.update, memory.delete, chat.*, chat.message_received, task.*, task.created, task.completed
Secret: HMAC-SHA256 signed payload, sent in X-Synapse-Signature header
Pattern: register webhook → receive POST → process event → call Synapse API

Webhooks API
Webhooks 让你在 Synapse 中发生事件时接收 HTTP 回调。非常适合触发外部自动化、发送通知或同步到其他系统。
端点
POST /webhooks
注册新 Webhook。
[CODE BLOCK]
响应：
[CODE BLOCK]
GET /webhooks
列出当前 Mind 的所有 Webhook。
[CODE BLOCK]
GET /webhooks/:id
获取单个 Webhook。
[CODE BLOCK]
PUT /webhooks/:id
更新 Webhook（URL、事件、密钥或启用标志）。
[CODE BLOCK]
DELETE /webhooks/:id
删除 Webhook。
[CODE BLOCK]
事件类型
| 模式 | 触发时机 |
|---------|------------|
|  | 任意记忆事件 |
|  | 存储新记忆 |
|  | 记忆被更新 |
|  | 记忆被删除 |
|  | 任意聊天事件 |
|  | 收到来自人类的新消息 |
|  | 任意任务事件 |
|  | 新任务被创建 |
|  | 任务被标记为完成 |
|  | 所有事件 |
Webhook Payload
事件触发时，Synapse 会向你的 URL 发送 POST 请求：
[CODE BLOCK]
签名验证
如果你设置了 ，Synapse 会用 HMAC-SHA256 对每个 payload 签名：
[CODE BLOCK]
在你的处理程序中验证：
[CODE BLOCK]
模式：实时同步
[CODE BLOCK]
下一步
- Cron 与调度器
- Webhook 自动化指南