---
title: "Agent Memory: save state between runs ($0.002/call)"
method: POST
path: "/kv"
tags: ["memory", "state", "kv-store", "agent", "persistence", "scratchpad", "checkpoint", "resume", "memory-between-runs"]
---

# Agent Memory: save state between runs ($0.002/call)

`POST /kv`

## Request

- Base URL: `https://x402.shizu.me`
- URL: `https://x402.shizu.me/kv`
- Auth: none declared

Your agent forgets everything when it exits. Checkpoint here and resume next run: POST {key, value, ttl?} stores JSON private to your paying wallet; GET ?key= restores it later. Resume long jobs where they stopped, skip work already done, remember what you told the user yesterday. Value up to 8KB, ttl up to 30d — durable memory as one call, no database.

Paid endpoint: $0.002 per call via the x402 protocol (USDC on Base). An unpaid request returns 402 with payment requirements in the PAYMENT-REQUIRED response header; attach payment and retry.

## Response `200`

Paid result (JSON)

## Other responses

- `402`: Payment required — x402 requirements in the PAYMENT-REQUIRED response header

---

[API](https://skmtc.dev/shizu/apis/scrape402.md) · [All operations](https://skmtc.dev/shizu/apis/scrape402/llms.txt) · [OpenAPI document](https://skmtc.dev/shizu/apis/scrape402/revisions/0852d74798b8?raw)