Build a MemoryStore Plugin

Register your plugin metadata and webhook endpoint using your personal MemoryStore authentication token. You must provide a publicly reachable https:// endpoint (localhost and private IPv4 ranges are strictly rejected by the validator).

Authorization: Bearer <YOUR_LOGIN_TOKEN>
Content-Type: application/json

{
  "name": "My Analyzer",
  "slug": "my-analyzer",
  "description": "What it does (shown to users)",
  "icon": "🔌",
  "webhook_url": "https://your-server.com/api/webhook",
  "health_endpoint": "https://your-server.com/api/health",
  "trigger_phrase": "run my analyzer",
  "result_url_template": "https://your-server.com/view/{{result_id}}",
  "milestones": [
    { "id": "receive", "label": "Video received" },
    { "id": "analyze", "label": "Analyzing content" }
  ]
}

Immediately after registration, the MemoryStore validation agent performs automated readiness probes against your server. The initial validation test message is intentionally unsigned — return 200 OK immediately and do not reject it for a missing signature:

// User-Agent: MemoryStore-Validation/1.0
{
  "event": "validation.test",
  "timestamp": "2026-09-10T12:00:00Z"
}

// Response: Return HTTP 200 OK
// within 10 seconds.

// Expected Response JSON:
{
  "status": "healthy",
  "checks": {
    "database": true,
    "ai_api": true
  }
}

Each individual check item inside checks must evaluate to a strict boolean (true or false). If no explicit health endpoint is defined during registration, our probe guesses one relative to your webhook base path.

When a user triggers your plugin (via iOS ShareSheet, Android, Web, or browser extension), MemoryStore delivers an HTTP POST payload to your webhook with the memory content, user preferences, and dynamic callback endpoints.

X-MemoryStore-Signature: sha256=a1b2c3d4e5...

{
  "event": "plugin.triggered",
  "result_id": "7b8e3a21-884c-4e12-a720-d98c2534f590",
  "callback_url": "https://api.memorystore.co.in/api/plugins/results/callback",
  "status_update_url": "https://api.memorystore.co.in/api/plugins/results/status",
  "memory": {
    "id": "mem_01h92k...",
    "title": "AI Coding Architecture Notes",
    "url": "https://www.instagram.com/reel/...",
    "transcript": "Here is the step by step process...",
    "download_url": "https://api.memorystore.co.in/api/plugins/media/mem_01h92k?pid=...&exp=17890123&sig=..."
  },
  "user_config": {
    "language": "en",
    "detailed_mode": true
  }
}

While your worker is analyzing or rendering, transmit real-time milestone transitions to {status_update_url}. MemoryStore client apps poll this status every 3 seconds to display an animated progress checklist to the user.

X-Plugin-Signature: sha256=<hmac of raw body>
Content-Type: application/json

{
  "result_id": "7b8e3a21-884c-4e12-a720-d98c2534f590",
  "milestone_id": "analyze",
  "status_message": "Analyzing video frames & audio transcript...",
  "completed_milestones": [
    {
      "id": "receive",
      "label": "Video received",
      "completed_at": "2026-09-10T12:00:03.120Z"
    }
  ]
}

Upon task completion or unexpected failure, transmit the final payload to {callback_url}. Provide rich structured JSON in result_data alongside an interactive web result view.

X-Plugin-Signature: sha256=<hmac of raw body>
Content-Type: application/json

{
  "result_id": "7b8e3a21-884c-4e12-a720-d98c2534f590",
  "status": "completed",
  "result_url": "https://your-server.com/view/7b8e3a21-884c-4e12-a720-d98c2534f590",
  "result_data": {
    "summary": "Complete step-by-step breakdown with actionable takeaways.",
    "takeaway": "Prioritize async webhooks and raw buffer HMAC validation.",
    "direct_url": "https://cdn.your-server.com/download/final-video.mp4",
    "thumbnail_url": "https://cdn.your-server.com/thumbs/thumb-01.jpg"
  }
}

To guarantee observability, stream operational telemetry logs to MemoryStore (trigger.received → process.started → process.completed). Batches are capped at 25 events per HTTP request. Never include private user credentials, raw passwords, or un-sanitized PII in log lines.