Docs / API Reference
API Reference
Base URL: https://api.kioku.dev
Authentication: Include your API key in the X-API-Key header with every request.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/memories | Create a new memory |
| GET | /v1/memories/search?q=... | Semantic search across memories |
| GET | /v1/memories/:id | Get a specific memory by ID |
| PATCH | /v1/memories/:id | Update a memory |
| DELETE | /v1/memories/:id | Soft-delete (tombstone) a memory |
| GET | /v1/agents | List agents in your organization |
| POST | /v1/agents/register | Register a new agent |
| GET | /v1/fleets | List fleets |
| POST | /v1/fleets | Create a fleet |
| GET | /v1/fleets/:id/members | List fleet members |
| GET | /v1/audit | Query audit log |
| GET | /v1/stats/dashboard | Dashboard statistics |
| GET | /v1/usage | Usage metrics for your org |
MCP Integration
Kioku supports the Model Context Protocol (MCP) via SSE transport. Agents connect to https://api.kioku.dev/mcp/sse with their API key in the X-API-Key header.
Available MCP tools:
- •
store_memory— Save a new memory - •
search_memories— Semantic search - •
get_memory— Retrieve by ID - •
list_fleet_memories— Browse fleet memories - •
promote_memory— Promote scope (agent → fleet → org)
Concepts
Organization
Top-level tenant. All agents, fleets, and memories belong to an org.
Fleet
A group of agents that can share memories. Agents can belong to multiple fleets.
Agent
An AI agent identity. Has a trust level, type, and fleet memberships.
Memory
A unit of knowledge — facts, observations, decisions, lessons. Has content, embeddings, trust scores, and scopes.
Scope
Visibility: agent (private), fleet (shared within fleet), org (visible to all agents).
Trust Score
0.0–1.0 confidence rating. Low-trust memories can be quarantined.
MCP
Model Context Protocol — SSE-based transport for real-time agent ↔ memory communication.