# Tabularium Write

> Tabularium Write is a paid API for AI agents from tabularium.matt-3e0.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-18).

Appends a UTF-8 value to a private, hash-chained key-value workspace owned by the paying wallet, returning a signed chain entry.

## Facts

- Endpoint: POST https://tabularium.matt-3e0.workers.dev/write?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tabularium-write-a2fd26c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DXlGF6SDzpiYK3QqBH8LD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tabularium-write-a2fd26c9 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tabularium-write-a2fd26c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tabularium.matt-3e0.workers.dev](https://www.zero.xyz/host/tabularium.matt-3e0.workers.dev/llms.txt)
