# AMEM.CONV.CREATE

> Create a conversation memory session with an optional window size.

URL: https://docs.hotkv.com/commands/amem-conv-create/

```
AMEM.CONV.CREATE session_id [WINDOW turns]
```

- Group: Agent memory
- Complexity: O(1)
- HotKV Cloud: Performance and Scale plans
- On-Premise: requires the agent-memory license feature

Agent memory gives AI agents four kinds of memory. Conversation memory keeps the recent turns of a chat session as a bounded sliding window: when a session holds its maximum number of turns, appending a new turn drops the oldest. `AMEM.CONV.CREATE` creates a session. You must create it before
you append turns with [AMEM.CONV.APPEND](https://docs.hotkv.com/commands/amem-conv-append/index.md).

## Options

| Option | Effect |
| --- | --- |
| `WINDOW turns` | The most turns the session keeps. Omitted or `0` uses the server default, `max_conv_turns` under `[agent_memory]` (100 unless you change it). |
| `TTL seconds` | The session ends after this many seconds: later appends answer `ERR session not found`. Omitted or `0` uses the server default, `amem.default-ttl`. |

## Return value

| Case | RESP2 | RESP3 |
| --- | --- | --- |
| Session created | Simple string `OK` | Same |

Errors:

- `ERR session already exists` if the session exists.
- `ERR invalid WINDOW` or `ERR invalid TTL` if the value is not a non-negative integer. No session is created.

- `ERR wrong number of arguments for 'amem.conv.create' command` if the argument count is wrong.
- `NOLICENSE agent-memory requires a HotKV license. Contact sales@hotkv.com` if your license does not include the `agent-memory` feature.

## Examples

```
127.0.0.1:6379> AMEM.CONV.CREATE agent-42 WINDOW 500
OK
127.0.0.1:6379> AMEM.CONV.CREATE agent-42
(error) ERR session already exists
```

## Compatibility

HotKV-only command. Redis and Valkey have no equivalent.

## See also

[AMEM.CONV.APPEND](https://docs.hotkv.com/commands/amem-conv-append/index.md), [AMEM.CONV.GET](https://docs.hotkv.com/commands/amem-conv-get/index.md), [AMEM.CONV.WINDOW](https://docs.hotkv.com/commands/amem-conv-window/index.md), [AMEM.CONV.CLEAR](https://docs.hotkv.com/commands/amem-conv-clear/index.md), [AMEM.CONV.DROP](https://docs.hotkv.com/commands/amem-conv-drop/index.md), [AI features guide](https://docs.hotkv.com/ai-features/index.md)