{"uid":"cap_DXlGF6SDzpiYK3QqBH8LD","slug":"tabularium-write-a2fd26c9","name":"Tabularium Write","description":"Agent memory: save a value under a key in a persistent key-value store owned by the paying wallet. The first write opens a 30-day workspace. Memory survives restarts, new machines and hand-offs between agents. Every write is hash-chained and signed (Ed25519), so the history verifies offline. Values up to 64 KB; failed writes are not charged.","url":"https://tabularium.matt-3e0.workers.dev/write?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"key":{"type":"string","pattern":"^[A-Za-z0-9._:/-]{1,128}$","description":"Key to append under"},"value":{"type":"string","maxLength":65536,"description":"UTF-8 value, up to 64 KB"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Optional retry id; a repeat returns the original entry"}}},"responseSchema":{"type":"json","example":{"ok":true,"head":{"seq":3,"sig":"<base64 Ed25519 signature over the head>","hash":"<entry hash>"},"entry":{"op":"write","ts":1790000000000,"key":"notes/today","seq":3,"hash":"<sha256 hex of this entry>","prev":"<hash of entry 2>","valueHash":"<sha256 hex of the value>"},"wallet":"0x...","expiresAt":1792592000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z-ZouJsmxkJuspfrsjkpb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Appends a UTF-8 value to a private, hash-chained key-value workspace owned by the paying wallet, returning a signed chain entry.","exampleAgentPrompt":"Append the value 'deployment succeeded at 14:32 UTC' under the key 'logs/deployments' in my Tabularium workspace, and use idempotency key 'deploy-2024-06-01-1432' so it's safe to retry.","exampleUseCases":[{"title":"Agent activity audit trail","prompt":"Add an entry to my Tabularium workspace under the key 'agent/actions' with the value 'searched web for quarterly earnings data' — use idempotency key 'action-20240601-001' so retries don't duplicate it."},{"title":"Tamper-evident configuration snapshot","prompt":"Write the current config value '{\"max_retries\":5,\"timeout\":30}' to my Tabularium workspace under the key 'config/worker-settings' so I have a verifiable record of what was deployed."},{"title":"Private research notes log","prompt":"Append my research note 'Found three peer-reviewed studies supporting the hypothesis; need to cross-check sample sizes.' under the key 'research/notes/2024-06' in my Tabularium workspace."}],"resultDescription":"Returns a JSON object with ok:true, the updated chain head (sequence number, Ed25519 signature over the head, and hash), the new entry object (operation, timestamp, key, sequence number, entry hash, previous entry hash, and hash of the value), the wallet address, and the workspace expiry timestamp. This lets the caller verify the chain position and integrity of the newly written entry offline.","failureModes":["Invalid key format (must match ^[A-Za-z0-9._:/-]{1,128}$) returns a validation error","Value exceeds 64 KB limit returns a payload-too-large error","Payment not included or insufficient USDC results in a 402 Payment Required response","Workspace expired requires renewal before writing","Idempotency key collision with a different key/value pair may return the original entry or an error","Network timeout on the Cloudflare Worker edge"],"whenToPreferThis":"Choose this endpoint when you need a cryptographically verifiable, append-only record tied to a specific wallet identity — e.g. audit logs, agent action histories, configuration snapshots, or any data where tamper-evidence and offline verifiability via Ed25519 signatures and hash chaining matter. Prefer it over generic key-value stores when chain integrity, wallet ownership, and per-entry signatures are requirements. Use the idempotency_key parameter when the write may be retried to avoid duplicate entries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T00:39:37.935Z","isFirstParty":false,"canonicalSlug":"tabularium-write-a2fd26c9"}