Skip to main content

​
Base URL

All endpoints are prefixed with /api/. There is no /v1/ prefix.
The base URL defaults to https://minns.ai/api/ for local development. Update this to your production URL when deploying.

​
Request format

  • All request bodies use JSON (Content-Type: application/json).
  • All responses return JSON.
  • Timestamps are u64 values representing nanoseconds since Unix epoch.
  • IDs are unsigned integers: u64 for most identifiers, u128 for EventId.

​
Server-generated fields

The server automatically generates certain fields if you omit them:
Best practice: Omit id, timestamp, and fingerprint and let the server generate them. This ensures consistency and reduces client complexity.

​
Null vs. omitted fields

​
Default query limits

​
System profiles

​
Endpoint groups

Events

Ingest events, retrieve event history, and view episodes.

Memory

Query long-term memories by agent or by context.

Strategies

Retrieve and search learned behavioral strategies.

Claims

List, get, and search extracted facts.

Graph

Explore the knowledge graph, analytics, and communities.

System

Health checks and server status.