# AMEM.CONV.APPEND

> Append one turn, with its role and content, to a conversation memory session.

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

```
AMEM.CONV.APPEND session_id role content
```

- 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.APPEND` adds a turn to the end of a session. `role`
is one of `system`, `user`, `assistant` or `tool`. HotKV records the time of the turn.

## Return value

| Case | RESP2 | RESP3 |
| --- | --- | --- |
| Turn appended | Simple string `OK` | Same |

Errors:

- `ERR session not found` if the session does not exist or has expired (create it with [AMEM.CONV.CREATE](https://docs.hotkv.com/commands/amem-conv-create/index.md)).
- `ERR invalid role, expected system, user, assistant or tool` for any other role. Nothing is appended.
- `ERR wrong number of arguments for 'amem.conv.append' 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.APPEND agent-42 user "What is the weather today?"
OK
127.0.0.1:6379> AMEM.CONV.APPEND agent-42 assistant "I'll check the weather for you."
OK
127.0.0.1:6379> AMEM.CONV.APPEND unknown-session user "hello"
(error) ERR session not found
```

## Compatibility

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

## See also

[AMEM.CONV.CREATE](https://docs.hotkv.com/commands/amem-conv-create/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)