Skip to content

API.md

Latest commit

 

History

History
159 lines (112 loc) · 2.04 KB

API.md

File metadata and controls

159 lines (112 loc) · 2.04 KB
Raw

MemoryLane API Reference

Overview

MemoryLane provides a local HTTP API for managing memories and sessions. Start the server with:

memorylane serve --port 3040

Endpoints

Health

GET /health

Response: { "status": "ok", "service": "memorylane", "version": "0.1.0" }

API Health

GET /v1/memorylane/health

Capabilities

GET /v1/memorylane/capabilities

Returns list of all available endpoints.

Save Memory

POST /v1/memorylane/memories
Content-Type: application/json

{
  "text": "User prefers short posts",
  "tags": ["writing", "preference"],
  "source": "chat",
  "importance": 8,
  "metadata": {},
  "sessionId": "ses_..."
}

List Memories

GET /v1/memorylane/memories?limit=10&tags=writing,preference

Get Memory

GET /v1/memorylane/memories/:id

Delete Memory

DELETE /v1/memorylane/memories/:id

Recall

POST /v1/memorylane/recall
Content-Type: application/json

{
  "query": "How should I write X posts?",
  "limit": 5,
  "tags": ["writing"],
  "sessionId": "ses_...",
  "minImportance": 3
}

Search

POST /v1/memorylane/search
Content-Type: application/json

{
  "query": "keyword",
  "limit": 10,
  "tags": ["writing"]
}

Create Session

POST /v1/memorylane/sessions
Content-Type: application/json

{
  "title": "Product Planning",
  "source": "cli",
  "metadata": {}
}

List Sessions

GET /v1/memorylane/sessions

Get Session

GET /v1/memorylane/sessions/:id

Returns session with all associated memories.

Export

POST /v1/memorylane/export

Returns all memories and sessions as JSON.

Import

POST /v1/memorylane/import
Content-Type: application/json

{
  "version": "0.1.0",
  "memories": [...],
  "sessions": [...]
}

Auth

In cloud mode, protected endpoints require:

Authorization: Bearer <TALOCODE_API_KEY>

or:

X-Api-Key: <TALOCODE_API_KEY>

Health and capabilities endpoints are always public.