Novyx RAM API

Persistent memory, semantic search, rollback, audit trails, replay debugging, and cortex intelligence for AI agents.

Base URL: https://novyx-ram-api.fly.dev

Authentication

All authenticated endpoints require a Bearer token:

Authorization: Bearer nram_{tenant_id}_{signature}

Get a free API key at novyxlabs.com or via POST /v1/keys.

Python SDK

pip install novyx

PyPI

JavaScript / TypeScript SDK

npm install novyx

npm

System Memories Auth & Keys Audit Rollback Context Spaces Sharing Knowledge Graph Traces Replay Cortex Context Plans & Billing Pricing

System

Method	Path	Auth	Description
GET	/health	No	Health check (disk, memory, Redis, audit)
GET	/healthz	No	Lightweight liveness probe
GET	/v1/status	Optional	API status and metrics
GET	/metrics	Yes	Prometheus metrics

curl https://novyx-ram-api.fly.dev/health

Memories

Method	Path	Description
POST	/v1/memories	Store a new memory
GET	/v1/memories	List memories with filters
GET	/v1/memories/search	Semantic search
GET	/v1/memories/stats	Memory statistics
GET	/v1/memories/graph	Memory graph (nodes and edges)
GET	/v1/memories/analytics	Quality analytics
POST	/v1/memories/bulk	Bulk delete/update
POST	/v1/memories/link	Create edge between memories
DELETE	/v1/memories/link	Remove edge
GET	/v1/memories/edges	List all edges
GET	/v1/memories/{id}	Get specific memory
GET	/v1/memories/{id}/history	Merge history (Enterprise)
GET	/v1/memories/{id}/links	Get edges for a memory
PATCH	/v1/memories/{id}	Update memory fields
DELETE	/v1/memories/{id}	Delete memory

Store a memory

curl -X POST https://novyx-ram-api.fly.dev/v1/memories \
  -H "Authorization: Bearer nram_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "observation": "User prefers dark mode",
    "tags": ["preferences"],
    "importance": 8
  }'

Semantic search

curl "https://novyx-ram-api.fly.dev/v1/memories/search?query=user+preferences&limit=5" \
  -H "Authorization: Bearer nram_your_key"

List memories

curl "https://novyx-ram-api.fly.dev/v1/memories?limit=20&min_importance=7" \
  -H "Authorization: Bearer nram_your_key"

Auth & API Keys

Method	Path	Auth	Description
POST	/v1/keys	No	Self-serve API key signup
POST	/v1/verify	No	Verify email and activate key
GET	/v1/verify	No	Verify email via GET link
POST	/v1/keys/rotate	Yes	Rotate API key (24h grace)
POST	/v1/keys/{id}/revoke	Yes	Revoke a key
GET	/v1/keys	Yes	List tenant's API keys
GET	/v1/usage	Yes	Current usage vs limits
POST	/admin/keys	Admin	Admin key creation
POST	/v1/keys/force-revoke	Admin	Force revoke by ID
GET	/v1/keys/analytics/signups	Admin	Signup analytics

Audit Trail

Method	Path	Tier	Description
GET	/v1/audit	All	Access audit log
GET	/v1/audit/summary	All	Audit summary statistics
GET	/v1/audit/health	All	Audit trail health
GET	/v1/audit/verify	All	Verify chain integrity
GET	/v1/audit/export	Pro+	Export as CSV/JSON

curl "https://novyx-ram-api.fly.dev/v1/audit?limit=20" \
  -H "Authorization: Bearer nram_your_key"

Rollback Pro+

Method	Path	Description
POST	/v1/rollback	Execute rollback to timestamp or relative time
GET	/v1/rollback/preview	Preview rollback changes (all tiers)
GET	/v1/rollback/suggest	AI-suggested rollback point
GET	/v1/rollback/history	Past rollback operations
POST	/v1/memories/rollback	Rollback by tag/criteria

# Preview
curl "https://novyx-ram-api.fly.dev/v1/rollback/preview?target=2+hours+ago" \
  -H "Authorization: Bearer nram_your_key"

# Execute
curl -X POST https://novyx-ram-api.fly.dev/v1/rollback \
  -H "Authorization: Bearer nram_your_key" \
  -H "Content-Type: application/json" \
  -d '{"target": "2 hours ago"}'

Context Spaces

Method	Path	Description
POST	/v1/context-spaces	Create space
GET	/v1/context-spaces	List spaces
GET	/v1/context-spaces/{id}	Get space
PUT	/v1/context-spaces/{id}	Update space
DELETE	/v1/context-spaces/{id}	Delete space
GET	/v1/context-spaces/{id}/memories	List memories in space

Method	Path	Description
POST	/v1/spaces/share	Generate share token
POST	/v1/spaces/share/{token}/rotate	Rotate share token
GET	/v1/spaces/shared	List spaces you've shared
GET	/v1/spaces/shared-with-me	List spaces shared with you
POST	/v1/spaces/join	Accept share token
DELETE	/v1/spaces/share/{token}	Revoke share

Knowledge Graph Pro+

Method	Path	Description
POST	/v1/knowledge/triples	Create triple
GET	/v1/knowledge/triples	List triples
GET	/v1/knowledge/triples/{id}	Get triple
DELETE	/v1/knowledge/triples/{id}	Delete triple
GET	/v1/knowledge/entities	List entities
GET	/v1/knowledge/entities/{id}	Traverse entity connections
DELETE	/v1/knowledge/entities/{id}	Delete entity

Traces Pro+

Method	Path	Description
POST	/v1/traces	Create trace session
POST	/v1/traces/{id}/steps	Add step to trace
POST	/v1/traces/{id}/complete	Finalize with RSA signature
GET	/v1/traces	List traces
GET	/v1/traces/{id}	Get trace with steps
GET	/v1/traces/{id}/certificate	Get signed certificate
GET	/v1/traces/public-key	RSA public key for verification
POST	/v1/traces/{id}/verify	Verify trace integrity

Replay Pro+

Time-travel debugging for AI agent memory.

Method	Path	Tier	Description
GET	/v1/replay/timeline	Pro+	Timeline of memory operations
GET	/v1/replay/snapshot	Pro+	Memory state at timestamp T
GET	/v1/replay/memory/{id}	Pro+	Full lifecycle of a memory
POST	/v1/replay/recall	Enterprise	Counterfactual recall at time T
GET	/v1/replay/diff	Pro+	Diff between two timestamps
GET	/v1/replay/drift	Enterprise	Memory composition drift

curl "https://novyx-ram-api.fly.dev/v1/replay/timeline?limit=20" \
  -H "Authorization: Bearer nram_your_key"

Cortex Pro+

Autonomous memory intelligence. Consolidates near-duplicates, boosts frequently-recalled memories, decays forgotten ones, and generates insights.

Method	Path	Tier	Description
GET	/v1/cortex/status	Pro+	Status, last run, config
GET	/v1/cortex/config	Pro+	Current configuration
PATCH	/v1/cortex/config	Pro+	Update configuration
POST	/v1/cortex/run	Pro+	Trigger manual cycle
GET	/v1/cortex/insights	Enterprise	Generated insights

curl https://novyx-ram-api.fly.dev/v1/cortex/status \
  -H "Authorization: Bearer nram_your_key"

Context

Method	Path	Description
GET	/v1/context/now	Temporal context snapshot (recent memories, upcoming deadlines)

Plans & Billing

Method	Path	Auth	Description
GET	/v1/plans	No	List all tiers and limits
POST	/v1/checkout	Yes	Create Stripe checkout session
POST	/v1/webhook/stripe	No	Stripe webhook
GET	/v1/billing	Yes	Stripe customer portal URL

Pricing

Tier	Price	Memories	API Calls/mo	Rollbacks	Audit
Free	$0	5,000	5,000	10/mo	7 days
Starter	$12/mo	25,000	25,000	30/mo	14 days
Pro	$39/mo	Unlimited	100,000	Unlimited	30 days
Enterprise	$199/mo	Unlimited	Unlimited	Unlimited	90 days

Pro+: Replay, Cortex, Traces, Knowledge Graph, Context Spaces sharing, audit export

Enterprise: Cortex insights, counterfactual recall, drift analysis, merge history

Novyx Labs — novyxlabs.com — GitHub