Memory: persistent KV store

memory_note · action · Utility · Available · v1.0.0

Description

Persistent key-value storage scoped per workflow — the primitive for stateful workflows that must remember data across runs: pagination cursors for incremental syncs, retry counters, "already processed" idempotency flags, KPI baselines.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`operation` Operazione	`enum` `getsetappenddeletelist`	yes	`get`	get = leggi valore. set = scrivi/sovrascrivi. append = aggiungi a stringa. delete = rimuovi. list = lista tutte le key di questo workflow.
`key` Chiave	`expression`	no	— last_pagination_cursor	Identifier univoco per workflow (snake_case raccomandato). Required per get/set/append/delete. Ignorato per list.
`value` Valore (per set/append)	`expression`	no	— {{$node.lastPage.json.cursor}}	Valore da scrivere. Object → serializzato JSON. Required per set/append. Per append: viene aggiunto in coda al valore esistente (con separator se configurato).
`default` Valore di default (solo get)	`expression`	no	— es. 0 oppure {{input.fallback}}	Se la key NON esiste, get ritorna questo valore (exists resta false, usedDefault=true). Vuoto = ritorna null.
`pattern` Filtro pattern (solo list)	`string`	no	— es. cursor:*	Glob opzionale per filtrare le key: * = molti caratteri, ? = un carattere. Es. "cursor:*" elenca solo le key che iniziano con "cursor:". Vuoto = tutte le key.
`appendSeparator` Separator (solo append)	`string`	no	`\n`	Default "\n" (newline). Usato SOLO se operation=append e key esiste gia\`. Es. "," → "a,b,c". Empty → concat puro.
`ttlSeconds` TTL secondi (auto-delete)	`number`	no	— 86400	Opzionale. Quando settato, la key scade dopo N secondi dall'ultimo write. Cleanup avviene lazy al prossimo read (key scaduta → output.exists=false, row deleted).

⬆️ Node output

Fields available to downstream nodes via $node.<alias>.json.<field>:

value
exists
updatedAt
expiresAt
usedDefault
oldValue
changed
keys
count
pattern
operation

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-memory_note-1",
  "defId": "memory_note",
  "label": "Memory: persistent KV store",
  "config": {
    "operation": "get",
    "appendSeparator": "\\n"
  }
}

🔗 Related nodes in the same category

Ready to use Memory: persistent KV store?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes