Store Memory API

Give your AI agents persistent memory across sessions via REST API. Store any JSON value under a named key — it survives context resets, container restarts, and new conversations. The fundamental building block for stateful agent applications.

How it works

POST a key, value, and optional namespace and tags. The value is stored in a persistent SQLite database, namespaced by your API key. Subsequent calls to memory-get with the same key return the stored value, even in a completely new agent session.

Use cases

• Remember user preferences across multiple conversations
• Store the current step in a multi-stage workflow the agent is executing
• Cache expensive computation results that can be reused in future sessions
• Persist counters, lists, and structured state for long-running agent tasks
• Share state between multiple agent instances working on the same task

API Reference

POST https://slopshop.gg/v1/memory-set
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Input parameters

Example response

{
  "data": {
    "key": "my-key",
    "value": "stored value",
    "updated_at": "2025-01-15T10:30:00Z"
  },
  "meta": {
    "credits_used": 1,
    "engine": "real",
    "ms": 4
  }
}

Examples

Three real-world scenarios showing how developers use Store Memory in production.

curl -X POST https://slopshop.gg/v1/memory-set \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "user_language", "value": "es", "namespace": "user:42"}'

curl -X POST https://slopshop.gg/v1/memory-set \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "workflow_step", "value": {"step": 3, "completed": ["fetch", "analyze"], "next": "generate"}, "namespace": "job:8821"}'

curl -X POST https://slopshop.gg/v1/memory-set \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "report_2024_q3", "value": {"summary": "Revenue up 15%..."}, "ttl": 3600}'

Code examples

curl

curl -X POST https://slopshop.gg/v1/memory-set \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "your data here"}'

Python

import requests

response = requests.post(
    "https://slopshop.gg/v1/memory-set",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"input": "your data here"}
)
result = response.json()
print(result["data"])

Node.js

const response = await fetch("https://slopshop.gg/v1/memory-set", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ input: "your data here" })
});
const { data } = await response.json();
console.log(data);

CLI

# Install the Slopshop CLI
npm install -g slopshop

# Set your API key
export SLOPSHOP_KEY=your_api_key

# Call memory-set
slop memory-set '{"input": "your data here"}'

Pricing

Credits are purchased in bundles starting at $1 for 1,000 credits. All compute APIs like this one use 1 credit per call — that's $0.001. See all pricing tiers.

Related APIs in Memory

• Retrieve Memory API — Retrieve a stored memory by its key within an optional namespace. Returns the value, creation timestamp, last-updated timestamp, and associated tags. Returns null if key does not exist.
• Search Memories API — Search stored memories by tag match, key substring, or value substring within an optional namespace. Returns all matching key-value pairs with their metadata, sorted by last-updated date.
• List All Memories API — List all stored memory keys in a namespace, with optional filtering by tag. Returns key names, creation dates, value sizes, and tags. Does not return values themselves (use memory-get for that).
• Delete Memory API — Delete a stored memory by key within an optional namespace. Returns confirmation including the deleted key and a timestamp. Silently succeeds if key does not exist.
• Set Memory TTL API — Set a time-to-live (TTL) on an existing memory key. The memory will be automatically deleted after N seconds. Passing TTL of 0 removes any existing expiry. Returns the absolute expiry timestamp.

View the full API catalog · Try in playground · Documentation