> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestión de Memoria

> Lee y escribe la memoria de sesión por usuario mediante la Memory API v2

La **Memory API** te permite gestionar el almacenamiento clave-valor por usuario de Jelou desde servicios externos. Es la misma memoria que ves como `$memory` en el builder y que usa `ctx.memory` en Functions — una sola memoria por usuario, no una copia paralela.

Úsala para persistir estado de conversación entre turnos: flujos multi-paso, carritos, contadores, preferencias y datos temporales sin una base de datos externa.

<Note>
  Para el uso desde Functions con el SDK (`ctx.memory`), consulta la guía [Memoria de sesión](/guides/functions/memoria). Esta sección documenta los endpoints REST directos de la Memory API v2.
</Note>

***

## Modelo de datos

Cada registro pertenece a un usuario y tiene:

* **Clave** — nombre de la variable.
* **Valor** — cualquier tipo JSON.
* **TTL por variable** — cuándo caduca esa variable individual (máximo 24h).
* **hashTTL** — cuándo caduca la memoria completa del usuario. Por defecto la plataforma aplica 30 días; puedes sobrescribirlo por solicitud con el encabezado `x-hash-ttl`.

## Identificación del usuario

La memoria de un usuario se identifica por su **`userReferenceId`** junto con el **`botId`**. Estos parámetros se envían en el cuerpo de cada solicitud para leer o escribir la memoria por referencia externa del usuario.

## Autenticación

Todas las peticiones se autentican con una **API key** en el encabezado `x-api-key` y se realizan a través del gateway de Jelou.

```
x-api-key: API_KEY
```

<Warning>
  La API key debe tener los scopes correspondientes: `memory:read` para lectura y `memory:write` para escritura. Consulta [Claves API](/guides/configuracion/claves-api) para crear y administrar tus claves.
</Warning>

***

## Recursos

<Steps>
  <Step title="Leer memoria">
    Obtén todos los registros de un usuario o un registro puntual por clave.

    [Ver obtener registros →](/api/memoria/obtener-registros) · [Ver obtener un registro →](/api/memoria/obtener-registro)
  </Step>

  <Step title="Escribir memoria">
    Guarda uno o varios registros por referencia de usuario (hasta 20 claves por solicitud).

    [Ver guardar registros →](/api/memoria/guardar-registros)
  </Step>
</Steps>