Quickstart

Get your first memory written in under 5 minutes.

1. Get an API key

Sign up at synapse.by-kit.com/signup. Free tier, CC required (not charged until you upgrade). Your key is shown once at creation — save it immediately.

Authentication

Pass your API key as a Bearer token in the Authorization header on every request:

Authorization: Bearer sk_syn_your_key_here

2. Write a memory

POST to /api/v1/record with your agent ID and the content to remember. No LLM is called. The body is stored in Postgres and classified by a local model.

curl -X POST https://synapse.by-kit.com/api/v1/record \
  -H "Authorization: Bearer sk_syn_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "my-agent",
    "type": "fact",
    "title": "User preference",
    "body": "User prefers responses under 3 sentences"
  }'

Response:

{
  "id": "a3f1b9c2-4e5d-4c2b-9f8a-1d2e3f4a5b6c",
  "created_at": "2026-05-20T12:00:00Z",
  "tenant_id": "550e8400-e29b-41d4-a716-446655440000"
}

3. Query it back

Use GET /api/v1/query with a keyword and your agent ID. Full-text search across everything your agent has ever written.

curl "https://synapse.by-kit.com/api/v1/query?q=preference&agent_id=my-agent" \
  -H "Authorization: Bearer sk_syn_your_key_here"

Response:

[
  {
    "id": "a3f1b9c2-4e5d-4c2b-9f8a-1d2e3f4a5b6c",
    "agent_id": "my-agent",
    "type": "fact",
    "title": "User preference",
    "body": "User prefers responses under 3 sentences",
    "created_at": "2026-05-20T12:00:00Z"
  }
]

That's it

Your agent now has persistent memory. Every session starts with full context.

Memory types

TypeWhen to use
factUser preferences, account details, static context
decisionA choice made, reasoning captured
exchangeConversation turns, Q&A pairs
deliverableArtifacts produced — documents, code, outputs
open_itemOpen tasks, follow-ups, unresolved questions
signalBehavioral signals, intent indicators

Next steps