API Reference

Webhooks

Receive real-time notifications when events occur in your ekkOS account.

Coming Soon

Webhooks are currently in development and will be available in an upcoming release. This page documents the planned functionality.

Planned Webhook Events

pattern.created

Triggered when a new pattern is created, either manually or through automatic discovery.

pattern.confidence_changed

Triggered when a pattern's confidence score crosses a threshold (e.g., becomes highly trusted or unreliable).

directive.created

Triggered when a new MUST/NEVER/PREFER/AVOID directive is created.

memory.consolidated

Triggered when memory consolidation occurs (e.g., working memory compressed to semantic).

conflict.detected

Triggered when conflicting patterns or knowledge are detected.

Planned Payload Format

{
  "event": "pattern.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "pat_abc123",
    "title": "Use Supabase Auth",
    "confidence": 0.5,
    "source": "forge_insight"
  },
  "account_id": "acc_xyz",
  "signature": "sha256=..."
}

Get Notified

Want to be notified when webhooks are available?

Available Now

REST API

Full API documentation

View API

MCP Tools

AI agent tools reference

View tools