Push webhooks are planned; use the SSE lifecycle stream for real-time notifications today.

Webhooks

Note

Push webhooks are not available in CortexDB v0.7.1. They are on the roadmap, but there is no webhook registration endpoint today — older docs that showed POST /v1/admin/webhooks were describing a feature that never shipped. The real-time surface today is the SSE lifecycle stream.

Real-time today: the lifecycle stream

GET /v1/lifecycle/stream is a Server-Sent Events feed of everything that happens to your memories — write-path progress, imports and exports, erasure jobs, and synthesis:

Event	Meaning
`captured` / `extracted` / `indexed` / `consolidated`	Write-path progress for an event
`forgotten`	A memory was forgotten
`import_progress` / `import_complete` / `import_error`	Bulk import jobs
`export_progress` / `export_complete`	Export jobs
`erasure_progress` / `erasure_complete`	GDPR erasure jobs
`synthesis_progress` / `synthesis_complete` / `synthesis_failed`	Understanding synthesis jobs

Filter with query parameters: scope, event_id, events (comma-separated event names), job_id, or since_lifecycle_id for catch-up.

curl -N "https://api-v1.cortexdb.ai/v1/lifecycle/stream?event_id=evt_01HX..." \
  -H "Authorization: Bearer $CORTEX_TOKEN" \
  -H "X-Cortex-Actor: $CORTEX_ACTOR"

See Async + Lifecycle for the full stream contract.

When push webhooks ship, they will deliver these same lifecycle events to an HTTPS endpoint you register. Until then, consume the SSE stream from a worker if you need to fan events out to your own systems.