# Webhooks API
SUMMARY: Rejestrowanie wywołań zwrotnych HTTP dla zdarzeń pamięci, czatu i zadań — powiadomienia o zmianach danych.

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
Webhooki pozwalają otrzymywać wywołania zwrotne HTTP, gdy w Synapse mają miejsce
zdarzenia. Idealne do wyzwalania zewnętrznej automatyzacji, wysyłania powiadomień
lub synchronizacji z innymi systemami.
Endpointy
POST /webhooks
Rejestruje nowy webhook.
[CODE BLOCK]
Odpowiedź:
[CODE BLOCK]
GET /webhooks
Lista wszystkich webhooków dla bieżącego umysłu.
[CODE BLOCK]
GET /webhooks/:id
Zwraca pojedynczy webhook.
[CODE BLOCK]
PUT /webhooks/:id
Aktualizuje webhook (URL, zdarzenia, sekret lub flagę enabled).
[CODE BLOCK]
DELETE /webhooks/:id
Usuwa webhook.
[CODE BLOCK]
Typy zdarzeń
| Wzorzec | Uruchamiane, gdy |
|---------|------------|
|  | Dowolne zdarzenie pamięci |
|  | Zapisano nowe wspomnienie |
|  | Zaktualizowano wspomnienie |
|  | Usunięto wspomnienie |
|  | Dowolne zdarzenie czatu |
|  | Nowa wiadomość od człowieka |
|  | Dowolne zdarzenie zadania |
|  | Utworzono nowe zadanie |
|  | Zadanie oznaczono jako ukończone |
|  | Wszystkie zdarzenia |
Payload webhooka
Gdy wystąpi zdarzenie, Synapse wysyła POST pod podany URL:
[CODE BLOCK]
Weryfikacja podpisu
Jeśli ustawiono , Synapse podpisuje każdy payload algorytmem HMAC-SHA256:
[CODE BLOCK]
Weryfikacja w obsłudze:
[CODE BLOCK]
Wzorzec: synchronizacja w czasie rzeczywistym
[CODE BLOCK]
Następne kroki
- Cron i Scheduler
- Przewodnik automatyzacji webhookami