{"uid":"cap_CH9oGmnjsm_wwO2gtL747","slug":"tabularium-key-read-d8d348a0","name":"Tabularium Key Read","description":"Agent memory: read the latest value for a key from the paying wallet's persistent key-value store, with its signed hash-chain entry. Reads keep working through the 90-day grace period after the term ends. A missing key returns 404 and is not charged.","url":"https://tabularium.matt-3e0.workers.dev/read?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["key"],"properties":{"key":{"type":"string","pattern":"^[A-Za-z0-9._:/-]{1,128}$"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"key":"notes/today","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>"},"state":"active","value":"Met the supplier; follow up Friday.","wallet":"0x...","expiresAt":1792592000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uKAq4VGCk9vd4BQoAyIL1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the latest value for a specified key in the paying wallet's private, hash-chained workspace, along with its chain entry metadata.","exampleAgentPrompt":"Fetch the latest value I stored under the key 'notes/today' from my Tabularium workspace, and include the chain entry so I can verify it.","exampleUseCases":[{"title":"Retrieve latest meeting note","prompt":"What's the current value I have stored under 'meetings/2025-07-15' in my Tabularium workspace? Show me the value and the chain entry."},{"title":"Audit trail check for a config key","prompt":"Pull the latest entry for the key 'config/api-endpoint' from my workspace — I need both the value and the chain hash so I can confirm it hasn't been tampered with."},{"title":"Agent reads its own state","prompt":"Look up the value stored under 'agent/task-status' in my Tabularium workspace so the agent can pick up where it left off."}],"resultDescription":"Returns a JSON object containing: the key name, the latest stored value (as a string), the chain entry (including operation type, timestamp, sequence number, hash, previous hash, and value hash), the workspace state (e.g. 'active'), the wallet address that owns the workspace, and the workspace expiry timestamp.","failureModes":["Key not found — returns an error if the specified key has never been written","Invalid key format — key must match pattern ^[A-Za-z0-9._:/-]{1,128}$","Payment failure — if the x402 micropayment of $0.002 USDC is not completed, access is denied","Expired workspace — if the wallet's workspace subscription has lapsed, read may be rejected","Unauthorized wallet — only the paying wallet's workspace is accessible"],"whenToPreferThis":"Choose this endpoint when you need to read the current value of a specific key from a private, hash-chained workspace tied to a wallet identity, and you want the cryptographic chain entry alongside the value for auditability. It is the right choice when you know the exact key name and want point-in-time retrieval rather than a full workspace dump. Prefer this over the full history endpoint when you only need the latest value, not the complete write history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T00:36:35.505Z","isFirstParty":false,"canonicalSlug":"tabularium-key-read-d8d348a0"}