Dokumentasi API

Semua yang Anda butuhkan untuk mengintegrasikan Seizn ke aplikasi Anda. Tambahkan memori jangka panjang ke AI Anda hanya dengan beberapa baris kode.

Mulai Cepat

Dapatkan kunci API Anda dari dasbor, lalu mulai mengirim permintaan:

bash

# Add a memory
curl -X POST https://seizn.com/api/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "User prefers dark mode interfaces"}'

# Search memories
curl "https://seizn.com/api/memories?query=user+preferences" \
  -H "Authorization: Bearer YOUR_API_KEY"

Autentikasi

Semua permintaan API memerlukan kunci API di x-api-key header.

bash

curl -H "Authorization: Bearer szn_your_api_key_here" \
  https://seizn.com/api/memories?query=test

Keamanan: Jaga kerahasiaan kunci API Anda. Jangan pernah mengeksposnya di kode sisi klien. Gunakan variabel lingkungan atau proxy backend.

Endpoint API

POST/api/memories

Tambahkan memori baru ke penyimpanan pengguna.

Body Permintaan

content-string (required)

memory_type-string - fact, preference, experience, relationship, instruction

tags-string[]

namespace-string (default: "default")

scope-string - user, session, agent

session_id-string

agent_id-string

Respons

{
  "success": true,
  "memory": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "content": "User prefers dark mode interfaces",
    "memory_type": "preference",
    "tags": ["ui", "settings"],
    "namespace": "default",
    "created_at": "2026-01-08T10:30:00Z"
  }
}

GET/api/memories

Cari memori berdasarkan kesamaan semantik.

Parameter Query

query-string (required)

limit-number (default: 10, max: 100)

threshold-number 0-1 (default: 0.7)

namespace-string

Respons

{
  "success": true,
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "User prefers dark mode interfaces",
      "memory_type": "preference",
      "tags": ["ui", "settings"],
      "similarity": 0.89
    }
  ],
  "count": 1
}

DELETE/api/memories

Hapus memori berdasarkan ID.

Parameter Query

ids-string (required) - comma-separated

Respons

{
  "success": true,
  "deleted": 3
}

POST/api/extract

Ekstrak dan simpan memori dari percakapan menggunakan AI.

Body Permintaan

conversation-string (required)

model-string - haiku | sonnet (default: haiku)

auto_store-boolean (default: true)

namespace-string (default: "default")

Respons

{
  "message": "Extracted 3 memories, stored 3",
  "extracted": [
    {
      "content": "User is a software developer working with Python",
      "memory_type": "fact",
      "tags": ["profession", "programming"],
      "confidence": 0.95,
      "importance": 7
    }
  ],
  "stored": [...]
}

POST/api/query

Dapatkan respons dari AI menggunakan memori relevan sebagai konteks (RAG).

Body Permintaan

query-string (required)

model-string - haiku | sonnet (default: haiku)

top_k-number (default: 5)

namespace-string

include_memories-boolean (default: true)

Respons

{
  "response": "Based on your preferences, I'd recommend using VS Code with a dark theme...",
  "memories_used": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "User prefers dark mode interfaces",
      "similarity": 0.85
    }
  ],
  "model_used": "haiku"
}

Batas

Paket	Panggilan API Bulanan	Memori maksimum	Kunci API
Gratis	1,000	100	2
Starter	50,000	5,000	3
Plus	500,000	50,000	5
Pro	2,000,000	Tidak terbatas	10
Enterprise	Tidak terbatas	Tidak terbatas	100

Ketika Anda melebihi batas, API mengembalikan 429 Too Many Requests respons.

Kode Error

Kode	Deskripsi
`200`	Sukses
`400`	Bad Request - Parameter hilang atau tidak valid
`401`	Unauthorized - Kunci API tidak valid atau hilang
`429`	Too Many Requests - Melebihi batas
`500`	Internal Server Error - Terjadi kesalahan

Keamanan & Tata Kelola

Keamanan Data

✓Enkripsi saat istirahat: Semua data dienkripsi dengan AES-256
✓Enkripsi saat transit: TLS 1.3 untuk semua koneksi
✓Isolasi tenant: Pemisahan data lengkap antar akun

Manajemen Kunci API

✓Rotasi kunci: Rotasi kunci kapan saja dari dasbor
✓Kedaluwarsa kunci: Kunci kedaluwarsa otomatis setelah 90 hari (dapat dikonfigurasi)
✓Pelacakan penggunaan: Pantau penggunaan per kunci secara real-time

Retensi & Penghapusan Data

✓Ekspor: Ekspor semua data kapan saja melalui API atau dasbor
✓Penghapusan: Penghapusan permanen tanpa retensi setelah 30 hari
✓GDPR/CCPA: Kepatuhan penuh terhadap hak subjek data

SDK

Python

bash

pip install seizn

python

from seizn import Seizn

client = Seizn(api_key="your_api_key")

# Add memory
client.add("User prefers dark mode")

# Search
results = client.search("preferences")

# Extract from conversation
client.extract(conversation="...")

JavaScript

bash

npm install seizn

javascript

import { Seizn } from 'seizn';

const client = new Seizn({ apiKey: 'your_api_key' });

// Add memory
await client.add('User prefers dark mode');

// Search
const results = await client.search('preferences');

// Extract from conversation
await client.extract({ conversation: '...' });

MCP Server — Every Editor, One Memory

The Seizn MCP Server (seizn-mcp) bridges your Seizn memories to AI coding assistants via the Model Context Protocol. 40+ tools, MCP Resources, webhooks, OAuth device flow, and multi-editor config sync — all in one package.

bash

# Install globally or use npx
npx seizn-mcp@latest

# Or add to Claude Code settings (~/.claude/settings.json)
{
  "mcpServers": {
    "seizn": {
      "command": "npx",
      "args": ["-y", "seizn-mcp@latest"],
      "env": { "SEIZN_API_KEY": "your-api-key" }
    }
  }
}

Supported Editors

> Claude Code — native MCP
> Cursor — native MCP
> Windsurf — native MCP
> Cline — native MCP
~ GitHub Copilot — via config sync
~ Aider — via config sync
~ OpenAI Codex — via config sync

Key Features

> 40+ MCP Tools — memories, knowledge graph, profile, webhooks, config sync
> MCP Resources — seizn://memories/recent, seizn://profile, seizn://context/{format}
> OAuth Device Flow — browser auth, no API key copy
> Auto Context — detects project from package.json, pyproject.toml, Cargo.toml
> UTF-8 Support — Korean, Japanese, Chinese, Arabic and 100+ languages

Multi-Editor Config Sync

Seizn exports your memories as editor-specific configuration files. Your AI preferences follow you across every tool.

File	AI Tool	Method
CLAUDE.md	Claude Code	MCP + File
AGENTS.md	OpenAI Codex	File Sync
.cursor/rules	Cursor	MCP + File
.windsurfrules	Windsurf	MCP + File
.github/copilot-instructions.md	GitHub Copilot	File Sync
.clinerules	Cline	MCP + File
CONVENTIONS.md	Aider	File Sync

OAuth Device Flow

No more copying API keys. The MCP server supports RFC 8628 Device Authorization Grant for browser-based authentication.

Run auth_login tool

Enter code ABCD-1234 in browser

Token saved to ~/.seizn/

Zero-copy auth: The device flow generates a human-readable code, opens your browser, and saves credentials automatically. Works with any terminal or SSH session.