Storage Nodes

Storage Nodes (Persistent Data)

Storage nodes provide CRUD operations for persistent data stores. Data persists across flow executions, enabling stateful workflows.

---

Overview

Persistent Data stores are key-value databases scoped to your tenant. Each store is identified by a UUID and can hold any JSON-serializable data.

Note

Persistent Data is stored in SQLite databases managed by the Go service.

---

Available Nodes

Store Add

Create a new record

Store Get

Retrieve record by key

Store Update

Update existing record

Store Delete

Delete record by key

Store Check

Check if record exists

Store Search

Query with filters

Store Count

Count records

---

Common Configuration

All storage nodes share this base configuration:

{
  data_store: string,  // UUID of the persistent data store
  params: {
    key?: string,      // Record identifier (required for most operations)
    // ... operation-specific params
  },
  metadata?: object    // Optional metadata
}

---

Store Add

Module ID: ion.store.add

Creates a new record in the store.

Configuration

params: {
  key: string,    // Unique identifier
  value: any      // Data to store
}

Outputs

Handle	Description
output	Created record
error	Key already exists or store error

Example

{
  "data_store": "550e8400-e29b-41d4-a716-446655440000",
  "params": {
    "key": "order_12345",
    "value": {
      "status": "processing",
      "items": 3,
      "total": 99.99
    }
  }
}

---

Store Get

Module ID: ion.store.get

Retrieves a record by its key.

Configuration

params: {
  key: string  // Record key to fetch
}

Outputs

Handle	Description
output	Found record data
error	Record not found or store error

---

Store Update

Module ID: ion.store.update

Updates an existing record.

Configuration

params: {
  key: string,    // Record key to update
  value: any      // New data (replaces existing)
}

Outputs

Handle	Description
output	Updated record
error	Record not found or store error

---

Store Delete

Module ID: ion.store.delete

Deletes a record by key.

Configuration

params: {
  key: string  // Record key to delete
}

Outputs

Handle	Description
output	Confirmation
error	Record not found or store error

---

Store Check

Module ID: ion.store.check

Checks if a record exists without retrieving it.

Configuration

params: {
  key: string  // Record key to check
}

Outputs

Handle	Description
found	Record exists
not_found	Record does not exist
error	Store error

---

Store Search

Module ID: ion.store.search

Queries records with filters.

Configuration

params: {
  filters: Array<{
    field: string,
    operator: string,
    value: any
  }>,
  limit?: number,
  offset?: number
}

Outputs

Handle	Description
output	Array of matching records
error	Invalid query or store error

---

Store Count

Module ID: ion.store.count

Returns the count of records matching criteria.

Configuration

params: {
  filters?: Array<Filter>  // Optional filters
}

Outputs

Handle	Description
output	Count result { count: number }
error	Store error

---

Store Delete All

Module ID: ion.store.delete_all

Deletes all records in the store.

Danger

This operation cannot be undone. All data in the store will be permanently deleted.

Outputs

Handle	Description
output	Confirmation
error	Store error

---

Common Patterns

Order State Tracking

[Webhook: Order Created] → [Store Add: order_{id}]
        ↓
[Webhook: Order Updated] → [Store Update: order_{id}]
        ↓
[Webhook: Order Fulfilled] → [Store Delete: order_{id}]

Check Before Create

[Input] → [Store Check: key]
              ├── found → [Store Update]
              └── not_found → [Store Add]

Aggregation

[Daily Trigger] → [Store Search: today's records] → [Iterator] → [Calculate] → [Report]

---

Error Cases

Error	Cause
”Missing ‘data_store‘“	No store UUID provided
”Invalid data_store”	Store UUID format invalid
”Persistent Data does not exist”	Store not found
”node not configured properly”	Missing params

---

See Also

• Flow Nodes Overview