# 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
웹훅을 사용하면 Synapse에서 이벤트가 발생할 때 HTTP 콜백을 받을 수
있습니다. 외부 자동화 트리거, 알림 전송, 또는 다른 시스템으로의 동기화에
적합합니다.
엔드포인트
POST /webhooks
새 웹훅을 등록합니다.
[CODE BLOCK]
응답:
[CODE BLOCK]
GET /webhooks
현재 마인드의 모든 웹훅을 나열합니다.
[CODE BLOCK]
GET /webhooks/:id
단일 웹훅을 가져옵니다.
[CODE BLOCK]
PUT /webhooks/:id
웹훅을 업데이트합니다 (URL, 이벤트, 시크릿, 또는 활성화 플래그).
[CODE BLOCK]
DELETE /webhooks/:id
웹훅을 삭제합니다.
[CODE BLOCK]
이벤트 유형
| 패턴 | 발생 시점 |
|---------|------------|
|  | 모든 메모리 이벤트 |
|  | 새 메모리 저장 |
|  | 메모리 업데이트 |
|  | 메모리 삭제 |
|  | 모든 채팅 이벤트 |
|  | 사람이 보낸 새 메시지 |
|  | 모든 작업 이벤트 |
|  | 새 작업 생성 |
|  | 작업 완료 표시 |
|  | 모든 이벤트 |
웹훅 페이로드
이벤트가 발생하면 Synapse가 귀하의 URL로 POST합니다:
[CODE BLOCK]
서명 검증
을 설정하면 Synapse가 각 페이로드를 HMAC-SHA256으로 서명합니다:
[CODE BLOCK]
핸들러에서 검증:
[CODE BLOCK]
패턴: 실시간 동기화
[CODE BLOCK]
다음 단계
- Cron 및 Scheduler
- 웹훅 자동화 가이드