API Reference

The MemNexus API is a REST API with 83 endpoints across 13 resource groups. All requests require authentication via API key.

Base URL

https://api.memnexus.ai

Authentication

All API requests require authentication. Pass your API key as a Bearer token in the Authorization header:

curl https://api.memnexus.ai/api/memories \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

API keys follow the format cmk_live_<id>.<secret>. Create keys in the dashboard or via the API Keys endpoints.

Endpoint groups

Group	Endpoints	Description
Memories	20	Memory management and retrieval endpoints
Conversations	7	Conversation tracking and analysis endpoints
Topics	9	Topic detection, clustering, and management endpoints
Communities	3	Topic community detection and management endpoints
Facts	6	Fact extraction and management endpoints
Entities	3	Entity extraction and discovery endpoints
Patterns	6	Pattern detection and behavioral analysis endpoints
Behavior	2	Behavioral pattern tracking and state management endpoints
GraphRAG	3	Graph-based retrieval augmented generation endpoints
Artifacts	5	Artifact storage and retrieval endpoints
API Keys	4	API key management endpoints
Narratives	8	Narrative thread management endpoints
System	7	System health, monitoring, and configuration endpoints

Error responses

All errors follow a consistent format:

{
  "error": "Error description"
}

Status	Meaning
400	Validation error — check your request body
401	Authentication error — check your API key
404	Resource not found
429	Rate limit exceeded — wait and retry
500	Internal server error

Rate limiting

The API enforces rate limits via the API Gateway. When rate limited, the response includes:

Retry-After: 60
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1706198400

OpenAPI specification

The full OpenAPI 3.0 specification is available:

• Live endpoint: GET /api/openapi.json
• Static file: /openapi.json (bundled with these docs)

Use this to generate clients in any language or import into tools like Postman.