LanOnasis API Reference
Welcome to the LanOnasis API documentation. Our REST API provides complete access to the Memory-as-a-Service platform with comprehensive endpoints for memory management, search, analytics, and real-time features. Welcome to the LanOnasis Memory-as-a-Service API documentation. Our REST API allows you to integrate powerful memory management and semantic search capabilities into your applications.
Base URL
https://api.lanonasis.com/api/v1
Production: https://api.lanonasis.com/api/v1
Sandbox: https://sandbox-api.lanonasis.com/api/v1
Authentication
All API requests require authentication. Use an API key header for key-based auth or a bearer token for OAuth/JWT:
X-API-Key: lano_your_api_key_here
Authorization: Bearer YOUR_TOKEN (OAuth/JWT)
Content-Type: application/json
Quick Start
curl -H "X-API-Key: lano_your_api_key_here" \
https://api.lanonasis.com/api/v1/memories
Quick Start
Get started with our API in minutes:
import { createMemoryClient } from '@lanonasis/memory-client/core';
const client = createMemoryClient({
apiUrl: 'https://api.lanonasis.com',
apiKey: 'your-api-key'
});
// Create a memory
const created = await client.createMemory({
title: 'Project Notes',
content: 'Important project notes',
metadata: { project: 'web-app' },
tags: ['work', 'important']
});
if (created.data) {
console.log('Memory ID:', created.data.id);
}
// Search memories
const results = await client.searchMemories({
query: 'project notes',
limit: 10
});
console.log('Matches:', results.data?.results);
# Create a memory
curl -X POST https://api.lanonasis.com/api/v1/memories \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Meeting Notes",
"content": "Discussed project timeline and deliverables",
"tags": ["meeting", "project"],
"metadata": {
"date": "2024-01-15",
"participants": ["john", "jane"]
}
}'
API Endpoints
🧠 Memory Management
POST /memories- Create a new memoryGET /memories/{id}- Retrieve a memoryPUT /memories/{id}- Update a memoryDELETE /memories/{id}- Delete a memoryGET /memories- List memories with pagination
🔍 Search & Discovery
POST /memories/search- Semantic search across memories
🔐 Authentication
POST /auth/api-keys- Create API keyGET /auth/api-keys- List API keysDELETE /auth/api-keys/{id}- Revoke API key
📊 Analytics
GET /analytics/usage- Usage statisticsGET /analytics/search- Search analytics
Response Format
All API responses follow a consistent format:
{
"success": true,
"data": {
// Response data here
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"request_id": "req_123456789"
}
}
Error Handling
Error responses include detailed information:
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": {
"field": "title",
"issue": "Title is required"
}
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"request_id": "req_123456789"
}
}
Rate Limits
| Plan | Requests/minute | Requests/hour | Storage |
|---|---|---|---|
| Free | 100 | 1,000 | 10MB |
| Pro | 1,000 | 10,000 | 1GB |
| Enterprise | 10,000 | 100,000 | Unlimited |
SDKs & Libraries
We provide official SDKs for popular programming languages:
Getting Help
Core Memory Operations
/api/v1/memories- Create and list memories/api/v1/memories/{id}- Get, update, or delete a memory
Search & Discovery
POST /memories/search- Semantic search across memoriesPOST /embeddings- Generate vector embeddings
Batch Operations
POST /batch- Perform multiple operations in a single request
Real-time Features
GET /stream- Server-sent events for real-time updatesPOST /webhooks- Configure webhook notifications
Analytics & Monitoring
GET /analytics- Retrieve usage analytics and metrics
Response Format
All API responses follow a consistent format:
Success Response
{
"success": true,
"data": {
// Response data here
},
"metadata": {
"request_id": "req_1234567890",
"timestamp": "2024-01-15T10:30:00Z"
}
}
Error Response
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message",
"details": {
// Additional error details
}
}
}
Rate Limits
| Tier | Requests/Minute | Requests/Hour | Burst Limit |
|---|---|---|---|
| Free | 60 | 1,000 | 100 |
| Pro | 300 | 10,000 | 500 |
| Enterprise | Custom | Custom | Custom |
SDKs & Libraries
We provide official SDKs for popular languages:
- TypeScript/JavaScript:
@lanonasis/memory-client - Python:
lanonasis-python - CLI:
lanonasis-cli
Interactive API Explorer
Try our API directly in your browser with our interactive explorer:
Support
Need help? We're here to assist:
- Documentation: Browse our comprehensive guides
- Community: Join our Discord community
- Support: Contact our support team
- Status: Check our system status