# Build with Redis Agent Memory

```json metadata
{
  "title": "Build with Redis Agent Memory",
  "description": "API reference, SDK examples, and language-specific guides for building with Redis Agent Memory.",
  "categories": ["docs","develop","ai"],
  "tableOfContents": {"sections":[{"id":"what-you-can-build","title":"What you can build"},{"id":"api-quick-start","title":"API quick start"},{"id":"language-guides","title":"Language guides"},{"id":"set-up-authentication","title":"Set up authentication"}]}

,
  "codeExamples": []
}
```
Everything you need to start building with Redis Agent Memory — REST API reference, SDK examples, and language-specific guides.

<div class="grid grid-cols-1 md:grid-cols-3 gap-6 my-8">
  
  
  
</div>

## What you can build

Redis Agent Memory gives your agents a two-tier memory layer available via REST API and Python SDK:

<ul class="my-4 space-y-2">
  <li class="flex gap-3"><span class="text-redis-red-500 font-bold mt-0.5">&#9679;</span><span><strong>Session memory</strong> — Store the current conversation as a sequence of events. Query by session ID to reconstruct context for the next agent turn.</span></li>
  <li class="flex gap-3"><span class="text-redis-red-500 font-bold mt-0.5">&#9679;</span><span><strong>Long-term memory</strong> — Automatically extract and persist important facts, preferences, and patterns from session events. Search semantically to retrieve what's relevant.</span></li>
  <li class="flex gap-3"><span class="text-redis-red-500 font-bold mt-0.5">&#9679;</span><span><strong>Multi-session recall</strong> — Retrieve memories across sessions and users using semantic search, with filtering by session, owner, namespace, topic, and memory type.</span></li>
  <li class="flex gap-3"><span class="text-redis-red-500 font-bold mt-0.5">&#9679;</span><span><strong>Direct memory writes</strong> — Bulk-create long-term memories from external sources without going through a session, for importing existing knowledge.</span></li>
</ul>

## API quick start

**1. Add a session event** — store a conversation turn in short-term memory:

```json
POST /v1/stores/{storeId}/session-memory/events
{
    "sessionId": "session-abc",
    "actorId": "user-123",
    "role": "USER",
    "content": [{ "text": "I prefer vegetarian restaurants." }],
    "createdAt": "2026-06-01T10:00:00Z"
}
```

Agent Memory automatically promotes important information (like preferences) to long-term memory in the background.

**2. Search long-term memory** — retrieve relevant context before the next agent response:

```json
POST /v1/stores/{storeId}/long-term-memory/search
{
    "text": "user dietary preferences",
    "filter": {
        "ownerId": { "eq": "user-123" }
    }
}
```

See the full [API and SDK examples](https://redis.io/docs/latest/develop/ai/context-engine/agent-memory/api-examples) for all endpoints, including session retrieval, memory deletion, and search filters.

## Language guides


The guides below show how to implement agent memory patterns **directly using Redis client libraries** — without the managed Agent Memory service. This is a good option if you prefer to self-host, want full control over the implementation, or are using a language that doesn't yet have an Agent Memory SDK. For the managed service, use the [REST API](https://redis.io/docs/latest/develop/ai/context-engine/agent-memory/api-examples) from any language.


Step-by-step examples for building agent memory into your application using your preferred Redis client library:

- [Python (redis-py)](https://redis.io/docs/latest/develop/use-cases/agent-memory/redis-py)
- [Node.js (node-redis)](https://redis.io/docs/latest/develop/use-cases/agent-memory/nodejs)
- [Go](https://redis.io/docs/latest/develop/use-cases/agent-memory/go)
- [Java (Jedis)](https://redis.io/docs/latest/develop/use-cases/agent-memory/java-jedis)
- [Java (Lettuce)](https://redis.io/docs/latest/develop/use-cases/agent-memory/java-lettuce)
- [.NET](https://redis.io/docs/latest/develop/use-cases/agent-memory/dotnet)
- [PHP](https://redis.io/docs/latest/develop/use-cases/agent-memory/php)
- [Ruby](https://redis.io/docs/latest/develop/use-cases/agent-memory/ruby)
- [Rust](https://redis.io/docs/latest/develop/use-cases/agent-memory/rust)

## Set up authentication

All API calls require an Agent Memory API key and a Store ID. Pass the key as a Bearer token and the store ID as a path parameter:

```sh
curl -X POST "https://$HOST/v1/stores/$STORE_ID/session-memory/events" \
    -H "Authorization: Bearer $API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ ... }'
```

To get your API endpoint, key, and Store ID, see [Create an Agent Memory service](https://redis.io/docs/latest/operate/rc/context-engine/agent-memory/create-service).