Agent

Agent KV memory (persistent scratchpad) API

Persistent per-namespace key-value memory so a stateless agent can remember things between calls and sessions. Ops: set (optional TTL), get, list, delete; values are arbitrary JSON. Authenticate with a namespace + token you choose (first use binds the token). Answers 'remember this for later', 'recall what I stored', 'persist state across runs', 'give my agent memory'.

Price$0.01per request

MethodPOST

Route/v1/agent/kv

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

agentmemorykvstorestatepersistencescratchpadrecall

API URLhttps://x402.hexl.dev/v1/agent/kv

Integration docs

Example request

{
  "op": "set",
  "namespace": "my-agent-7f3a",
  "token": "a-secret-you-keep",
  "key": "last_run",
  "value": {
    "step": 3,
    "status": "ok"
  },
  "ttlSeconds": 86400
}

Example response

{
  "op": "set",
  "key": "last_run",
  "expiresAt": "2026-06-04T00:00:00.000Z"
}

Input schema

{
  "type": "object",
  "required": [
    "op",
    "namespace",
    "token"
  ],
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "set",
        "get",
        "list",
        "delete"
      ]
    },
    "namespace": {
      "type": "string",
      "examples": [
        "my-agent-7f3a"
      ]
    },
    "token": {
      "type": "string",
      "examples": [
        "a-secret-you-keep"
      ]
    },
    "key": {
      "type": "string"
    },
    "value": {},
    "ttlSeconds": {
      "type": "number"
    },
    "prefix": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 100
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}