Saltar al contenido principal
POST
Save records

Descripción

Crea o actualiza registros de memoria de un usuario identificado por userReferenceId y botId. Acepta un máximo de 20 claves por solicitud.

Endpoint

Parámetros del cuerpo

userReferenceId
string
requerido
Identificador de referencia externo del usuario.
botId
string
requerido
Identificador del bot asociado a la memoria.
values
object
requerido
Mapa de clave → estructura de registro. La clave es el nombre de la variable. Máximo 20 claves por solicitud.Cada estructura de registro contiene:
  • value (requerido) — valor a almacenar. Puede ser cualquier tipo JSON.
  • ttl — TTL de la variable en segundos. Máximo 86400 (24h).
  • contentType — tipo de contenido opcional del valor.
Cada valor debe enviarse como un objeto { "value": ... }. Un valor plano (por ejemplo "paso": "confirmacion") se guarda vacío.

Encabezados opcionales

x-hash-ttl
integer
TTL en segundos para el hash completo de la memoria del usuario.

Autenticación

Todas las peticiones deben incluir el encabezado x-api-key con una API key que tenga el scope memory:write.

Ejemplo de solicitud

cURL

Respuestas

Ejemplo de respuesta

Autorizaciones

x-api-key
string
header
requerido

API key del proyecto de Jelou

Encabezados

x-hash-ttl
integer

TTL in seconds for the user's full memory hash. Optional.

Cuerpo

application/json
userReferenceId
string
requerido

External reference identifier of the user.

botId
string
requerido

Identifier of the bot associated with the memory.

values
object
requerido

Map of key to record structure. The key is the variable name. Maximum 20 keys per request.

Respuesta

Records saved successfully.