Integration · SDK & Developer API

One memory layer, every interface

The official Kiomon TypeScript SDK and REST API allow developers to wire persistent memory directly into custom agent swarms, workflows, and production services.

Official TypeScript SDK

Install the SDK from npm for full type safety, automatic retries, and strict schema validation:

npm install @kiomon/kiomon

Every SDK method maps 1:1 onto Kiomon's 12 memory-native verbs:

import { Kiomon } from "@kiomon/kiomon";

const client = new Kiomon({ apiKey: process.env.KIOMON_API_KEY });

// 1. Pre-flight context orientation
const context = await client.getWorkspaceContext({ workspace: "core" });

// 2. Intent-aware memory retrieval
const memories = await client.retrieveMemory({
  workspace: "core",
  intent: "execute",
  query: "deploy vector service",
});

// 3. Save what your agent learned
await client.draftMemory({
  workspace: "core",
  kind: "procedural",
  title: "Deploy pipeline checklist",
  body: "Always verify migration status before triggering deploy.",
  confidence: 0.95,
});

REST API Authentication

All direct HTTP requests use a workspace API key. Create one in your dashboard and send it as Authorization: Bearer <token> alongside your workspace ID. Keys are scoped to a workspace and revocable at any time.

Core endpoints

MethodPathWhat it does
POST /api/memories Draft or commit a memory (kind, title, body, workspace).
GET /api/search Hybrid search across memories and files in a workspace.
GET /api/workspaces List workspaces and their IDs.
GET /api/memories/:id Fetch a memory in full, with strength/stats and graph relations.
GET /api/memories/:id/graph Explore 1-hop graph relations (derived_from, supports, contradicts, …).
POST /api/memories/:id/manage Pin, archive, restore, forget, rate, approve, reject.

Endpoint paths mirror the MCP toolset one-to-one, so anything you build on REST keeps working if you later adopt MCP.

Use cases

  • Custom agent swarms and multi-agent pipelines that orchestrate memory centrally.
  • CI/CD hooks that commit project decisions to the graph on every merge.
  • Internal tools that surface searchable institutional knowledge.
  • Evals: script thousands of memory writes/reads for testing your prompts.

Get access

Create a free workspace to get your token, or reach out via contact for higher-rate plans and SLA-backed uptime.