10 Entity Types
Memories, Issues, Decisions, Work Logs, Architecture, Best Practices, Patterns, Observations, Tags, and Relationships
AI Builder
Bulk import API powered by OpenAI, Claude, or Gemini for atomic plan creation
Secure Authentication
JWT tokens and API keys for secure access. PostgreSQL-only architecture for all tiers.
Knowledge Graph
12 relationship types with temporal awareness, point-in-time traversal, versioning, and BFS graph algorithm
Temporal Knowledge Graph
Point-in-time graph traversal, relationship versioning, and episodic memory grouping
Background Agents
5 autonomous agents: memory cleanup, issue triage, graph maintenance, context optimization, observation consolidation
Hybrid Search
Semantic + graph proximity reranking with configurable weights across all entity types
Quick Start
Get started with the ACE API in 3 steps
1. Install ACE (requires Node.js 18+)
npm install -g @ace3-memory/ace
2. Login and initialize
ace login ace init ace start
3. Create your first issue
curl -X POST http://localhost:7777/api/v1/my-namespace/issues \
-H "Content-Type: application/json" \
-d '{
"title": "Test issue",
"description": "My first ACE issue",
"priority": "P2"
}'API Details
Base URL (Local)
http://localhost:7777/api/v1Authentication
Bearer YOUR_JWT_TOKENContent Type
application/jsonVersion
v1 (current)Core Endpoints
Universal CRUD pattern for all entity types
POST /api/v1/{namespace}/issuesCreate issueGET /api/v1/{namespace}/issuesList issuesPOST /api/v1/{namespace}/decisionsCreate decisionPOST /api/v1/{namespace}/work-logsLog workPOST /api/v1/{namespace}/relationshipsCreate relationshipGET /api/v1/{namespace}/relationships/traverseTraverse graphPOST /api/v1/{namespace}/plans/bulkAI BuilderGET /api/v1/{namespace}/relationships/traverse/{type}/{id}?as_of=Temporal traversalPOST /api/v1/{namespace}/episodesCreate episodePOST /api/v1/{namespace}/hybrid-searchHybrid searchGET /api/v1/agents/statusAgent statusGET /api/v1/{namespace}/audit-logAudit trailFull API Reference
Explore complete documentation with interactive testing