{"uid":"cap_s2xDy19EK4ETwzreKAOTg","slug":"dead-drop-key-value-store-put-45e8d016","name":"Dead Drop Key-Value Store (PUT)","description":"Store the request body under {key} in box {box} (a box_ id, a channel name, or \"me\" for your wallet's box). Query ttl=seconds (60 to 604800, default 3600). Body up to 65536 bytes. Returns the stored item with its box id, which free GET /box/{box}/{key} reads need.","url":"https://dead-drop.chris15118-4cd.workers.dev/box/:box/:key?utm_source=zero.xyz","method":"PUT","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["PUT"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object","required":["box","key"],"properties":{"box":{"type":"string"},"key":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_BdK3Zvdc8s9bjJseJsa7p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores an arbitrary payload (up to 65 KB) under a named key within a specified box, with a configurable TTL, returning the stored item and its box ID.","exampleAgentPrompt":"Save this JSON payload under the key 'session-result' in box 'box_abc123' for 7200 seconds: {\"status\":\"complete\",\"score\":42}.","exampleUseCases":[{"title":"Agent handoff via shared box","prompt":"Store this task result under the key 'handoff-payload' in my wallet's box (use 'me') with a 2-hour TTL: {\"task\":\"summarize\",\"result\":\"Done — see attachment\"}."},{"title":"Temporary channel message drop","prompt":"Drop this notification payload under key 'alert-2024-05-20' in the channel named 'ops-alerts' and keep it for 30 minutes: {\"level\":\"warn\",\"msg\":\"CPU over 90%\"}."},{"title":"Cross-agent shared state cache","prompt":"Write the value {\"step\":3,\"status\":\"waiting\"} to key 'pipeline-state' in box 'box_xyz789' and set it to expire in 10 minutes."}],"resultDescription":"Returns a JSON object containing the stored item (the body that was written), the resolved box ID, the key it was stored under, and the TTL in seconds. This box ID is needed for subsequent free GET requests to read the value back.","failureModes":["Body exceeds 65536 bytes — request rejected","TTL out of range (below 60 or above 604800) — validation error","Invalid or missing box/key path parameters — 400 error","Payment not included or insufficient — 402 Payment Required","Box ID does not exist or is inaccessible — 404 or 403 error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to temporarily persist a small payload (under 64 KB) under a named key so another agent, service, or user can retrieve it later via a free GET. It is ideal for agent-to-agent handoffs, ephemeral shared state, dead-drop messaging patterns, or any scenario where data must be parked briefly and addressed by a logical name. Prefer it over durable databases when the data is short-lived and cost-per-write matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:38:15.426Z","isFirstParty":false,"canonicalSlug":"dead-drop-key-value-store-put-0a1d75f2"}