2s Agent Memory Put

x402

2s Agent Memory Put is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-14).

Stores or updates a key-value pair in persistent agent memory with optional TTL, returning the stored item's metadata.

Price / call$0.0012

Seller volume →—

Success0%

StatusUnknown

How this service works

The (most) everything API: one pay-per-call API giving AI agents ground-truth data across hundreds of endpoints — public records, finance, crypto, security, legal, health, geo, and EDI. USDC via x402, no signup, no API keys.

Output

Returns a JSON object with ok:true and an items array containing the stored entry's key, etag, createdAt, updatedAt, expiresAt, and sizeBytes. Confirms successful write.

Example use cases

Example prompt

“Remember the value {"status":"active","score":42} under the key 'projects/2026/q1' in agent memory — keep it for 7 days (604800 seconds).”

Technical details

Endpoint

POSThttps://2s.io/api/agent/memory/put

When to prefer

Use this endpoint when an AI agent needs to persist arbitrary JSON state between sessions or tool calls without signing up for a dedicated storage service. Ideal for lightweight stateful memory where pay-per-use pricing is preferred over monthly storage subscriptions, and when the agent already operates within the 2s.io x402 payment ecosystem.

Side effects

Key contains invalid characters (outside A-Za-z0-9._/-) — validation error returned
Value exceeds 64 KiB serialized — payload too large error
TTL outside range 1..31536000 — invalid parameter error
Payment fails or insufficient USDC balance — 402 Payment Required
Key not provided — missing required field error

Input

{
  "key": "test-memory-entry",
  "value": {
    "message": "Hello from QA test",
    "timestamp": "2024-01-15T10:30:00Z"
  },
  "ttlSeconds": 3600
}

Schema · Request body

Field	Type	Description
key	string	1-200 chars from [A-Za-z0-9._/-].
value	—	Arbitrary JSON (object/array/scalar). Max 64 KiB serialized.
ttlSeconds	integer	Optional TTL 1..31536000. Omit for no expiry.

Output

{
  "data": {
    "ok": true,
    "items": [
      {
        "key": "test-memory-entry",
        "etag": "36aa4caaaa27e350",
        "createdAt": "2026-06-12T05:07:54Z",
        "expiresAt": "2026-06-18T07:24:36Z",
        "sizeBytes": 67,
        "updatedAt": "2026-06-18T06:24:36Z"
      }
    ],
    "total": 1,
    "source": {
      "url": "https://2s.io",
      "license": "No upstream data license",
      "provider": "2s.io agent primitives"
    }
  },
  "meta": {
    "cost": {
      "usd": 0.0012,
      "tier": 0
    },
    "caller": "x402",
    "version": null,
    "endpoint": "agent.memory.put",
    "settlement": {
      "txHash": "0xae1bd365e702d25d7d27e3191108a9861e5d11392da3911d7236c28a96f5b8b2",
      "network": "eip155:8453",
      "success": true
    }
  }
}

Schema · Response

Field	Type	Description
datarequired	object
metarequired	object

Reviews

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"

How this service works

Output

Returns a JSON object with ok:true and an items array containing the stored entry's key, etag, createdAt, updatedAt, expiresAt, and sizeBytes. Confirms successful write.

Technical details

Endpoint

POSThttps://2s.io/api/agent/memory/put

When to prefer

Side effects

Key contains invalid characters (outside A-Za-z0-9._/-) — validation error returned
Value exceeds 64 KiB serialized — payload too large error
TTL outside range 1..31536000 — invalid parameter error
Payment fails or insufficient USDC balance — 402 Payment Required
Key not provided — missing required field error

Input

{
  "key": "test-memory-entry",
  "value": {
    "message": "Hello from QA test",
    "timestamp": "2024-01-15T10:30:00Z"
  },
  "ttlSeconds": 3600
}

Schema · Request body

Field	Type	Description
key	string	1-200 chars from [A-Za-z0-9._/-].
value	—	Arbitrary JSON (object/array/scalar). Max 64 KiB serialized.
ttlSeconds	integer	Optional TTL 1..31536000. Omit for no expiry.

Output

{
  "data": {
    "ok": true,
    "items": [
      {
        "key": "test-memory-entry",
        "etag": "36aa4caaaa27e350",
        "createdAt": "2026-06-12T05:07:54Z",
        "expiresAt": "2026-06-18T07:24:36Z",
        "sizeBytes": 67,
        "updatedAt": "2026-06-18T06:24:36Z"
      }
    ],
    "total": 1,
    "source": {
      "url": "https://2s.io",
      "license": "No upstream data license",
      "provider": "2s.io agent primitives"
    }
  },
  "meta": {
    "cost": {
      "usd": 0.0012,
      "tier": 0
    },
    "caller": "x402",
    "version": null,
    "endpoint": "agent.memory.put",
    "settlement": {
      "txHash": "0xae1bd365e702d25d7d27e3191108a9861e5d11392da3911d7236c28a96f5b8b2",
      "network": "eip155:8453",
      "success": true
    }
  }
}

Schema · Response

Field	Type	Description
datarequired	object
metarequired	object