{"uid":"cap_Vjf--PNf8xyBPzysm7wqA","slug":"payperwork-box-key-value-store-put-6cbe47f9","name":"PayPerWork Box 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.","url":"https://payperwork.app/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_Dx0IvgmDGfzUpEZjpqUtH","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 JSON/form/text payload under a named key within a specified box (wallet box, channel, or 'me'), with a configurable TTL.","exampleAgentPrompt":"Save this JSON payload {\"status\": \"done\", \"result\": 42} under the key 'task-result' in my wallet box ('me'), keeping it for 7200 seconds.","exampleUseCases":[{"title":"Agent workflow state handoff","prompt":"Store the current workflow state {\"step\": 3, \"context\": \"approved\"} under the key 'workflow-state' in box 'box_abc123' so the next agent step can pick it up — keep it for 3600 seconds."},{"title":"Shared channel data drop","prompt":"Write this report summary {\"report\": \"Q2 sales up 12%\"} to key 'q2-report' in the channel box 'sales-team', and make it expire after 86400 seconds."},{"title":"Personal wallet box cache","prompt":"Save my user preferences {\"theme\": \"dark\", \"lang\": \"en\"} under the key 'user-prefs' in my own box (use 'me') with a TTL of 604800 seconds."}],"resultDescription":"Returns a confirmation that the payload has been stored, along with metadata such as the box ID, key name, and the sequence number for the write — which can be used with the corresponding GET or block-wait endpoint to retrieve or monitor the value.","failureModes":["Body exceeds 65536 bytes — request rejected with payload-too-large error","TTL outside 60–604800 range — rejected with invalid parameter error","Invalid or inaccessible box ID — returns 404 or authorization error","Malformed key name — rejected with bad request error","Payment failure (x402 protocol) — returns 402 Payment Required","Rate limiting — returns 429 Too Many Requests"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to persist ephemeral state, share data between agent steps or agents via a named box, or cache intermediate results with a TTL. It is purpose-built for agentic workflows where data needs to be readable by key later (via a sibling GET or block-wait endpoint). Prefer this over generic object storage when you need tight TTL control (60s–7 days), per-call micropayment pricing via x402, and native compatibility with the payperwork.app agent ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:33.552Z","isFirstParty":false,"canonicalSlug":"payperwork-box-key-value-store-put-6cbe47f9"}