API Reference

Complete documentation for the CLS++ Memory API. Store, retrieve, and manage conversation context across LLM providers.

Base URL:https://api.clsplusplus.com

Authentication

All API requests require authentication via Bearer token in the Authorization header.

Authorization: Bearer cls_your_api_key_here

Quick Start

import { CLSMemory } from '@cls-memory/sdk';

const memory = new CLSMemory({
  apiKey: process.env.CLS_API_KEY!,
});

// Store after Claude conversation
await memory.store({
  sessionId: 'user-123',
  provider: 'claude',
  messages: conversation.messages,
  metadata: { topic: 'React development' }
});

// Retrieve for GPT
const context = await memory.retrieve({
  sessionId: 'user-123',
  targetProvider: 'gpt-4',
});

// Use with OpenAI
const response = await openai.chat.completions.create({
  model: 'gpt-4',
  messages: context.messages,
  ...context.systemContext,
});

Endpoints

POST/v1/memory/store

Store conversation context for a session

Request

{
  "session_id": "user-123",
  "provider": "claude",
  "messages": [
    { "role": "user", "content": "Hello" },
    { "role": "assistant", "content": "Hi there!" }
  ],
  "metadata": {
    "user_preferences": { "style": "concise" }
  }
}

Response

{
  "success": true,
  "memory_id": "mem_abc123",
  "session_id": "user-123",
  "stored_at": "2024-01-15T10:30:00Z"
}

GET/v1/memory/retrieve

Retrieve context for a session, optionally formatted for a target provider

Request

// Query params:
?session_id=user-123
&target_provider=gpt
&limit=50

Response

{
  "session_id": "user-123",
  "messages": [...],
  "system_prompt": "Continue the conversation...",
  "context": {
    "summary": "User is building a React app",
    "key_topics": ["React", "TypeScript"],
    "user_preferences": { "style": "concise" }
  },
  "retrieved_at": "2024-01-15T10:35:00Z"
}

DELETE/v1/memory/clear

Clear all memory for a session

Request

{
  "session_id": "user-123",
  "confirm": true
}

Response

{
  "success": true,
  "cleared_at": "2024-01-15T10:40:00Z"
}

GET/v1/memory/sessions

List all active sessions

Request

// Query params:
?limit=20
&offset=0

Response

{
  "sessions": [
    {
      "session_id": "user-123",
      "created_at": "2024-01-15T10:00:00Z",
      "last_updated": "2024-01-15T10:35:00Z",
      "message_count": 24
    }
  ],
  "total": 1,
  "has_more": false
}

Rate Limits

Plan	Requests/Day	Requests/Minute
Free	50	10
Pro	10,000	100
Enterprise	Unlimited	Custom

Get Your API Key