Skip to main content
Public BetaWe're in Public Beta. Things may break. Please report issues via the Support tab.

REST API

Universal memory infrastructure accessible via HTTP REST API

9 Entity Types

Issues, Decisions, Work Logs, Architecture, Best Practices, Patterns, Tags, Relationships, and Generic Memories

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

Create relationships between entities with 10 relationship types and traverse the graph with BFS algorithm

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/v1

Authentication

Bearer YOUR_JWT_TOKEN

Content Type

application/json

Version

v1 (current)
Core Endpoints
Universal CRUD pattern for all entity types
POST /api/v1/{namespace}/issuesCreate issue
GET /api/v1/{namespace}/issuesList issues
POST /api/v1/{namespace}/decisionsCreate decision
POST /api/v1/{namespace}/work-logsLog work
POST /api/v1/{namespace}/relationshipsCreate relationship
GET /api/v1/{namespace}/relationships/traverseTraverse graph
POST /api/v1/{namespace}/plans/bulkAI Builder
Full API Reference
Explore complete documentation with interactive testing

Access the complete API reference with:

  • All 60+ endpoints documented
  • Complete field schemas with types and descriptions
  • Interactive "Try it out" testing against your ACE instance
  • Request/response examples for every endpoint
  • OpenAPI spec for Postman and ChatGPT integration

Requires login to access