{"uid":"cap_cHDbwjG1rAJFw2oSXWl2T","slug":"agent-exec-storage-object-replace-9e26c5c0","name":"agent-exec Storage Object Replace","description":"Accountless, pay-per-use code execution for software agents: submit source code, get stdout, stderr and exit code back from an isolated, network-less sandbox. No account, no API key -- possession of valid payment is sufficient.","url":"https://agent-exec.448c.net/storage/%7Bid%7D/replace?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"plan":{"enum":["small","medium","large"],"type":"string","description":"Optional; omitted, misspelled or too small for the new body, you get the smallest plan it fits, and the 402 quotes exactly that. Which plan to buy. Priced as a fresh store, because the content is entirely new. Its byte allowance must cover the NEW body, and its window is compared against what the object already has -- the longer of the two wins, so replacing early never shortens your retention."},"label":{"type":"string","description":"Three-way. OMIT it to keep the object's current label (the usual case -- you are re-parking state under a name you already know). Send `?label=name` to rename. Send it empty (`?label=`) to clear it."}}},"responseSchema":{"type":"object","required":["id","expiresAt","previousExpiresAt","size","previousSize","plan","label","payment"],"properties":{"id":{"type":"string"},"plan":{"enum":["small","medium","large"],"type":"string"},"size":{"type":"integer","description":"The new content size, in bytes."},"label":{"type":["string","null"],"description":"The resulting label -- unchanged, renamed, or cleared, per the `?label=` sent."},"payment":{"type":"object","properties":{"asset":{"type":"string"},"payer":{"type":"string","description":"The paying wallet's address."},"amount":{"type":"string","description":"Atomic units of the settlement asset that were charged."},"network":{"type":"string"},"transaction":{"type":"string","description":"On-chain settlement transaction hash."}}},"expiresAt":{"type":"integer","description":"Unix ms the object is free again, after this replacement."},"previousSize":{"type":"integer","description":"The size of the content that was overwritten, in bytes."},"previousExpiresAt":{"type":"integer","description":"Unix ms the object would have expired before this replacement."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0051","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.0051/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0051","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0051","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Mnv44vfh4ehU91yMobAHh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0051","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Replaces the content of an existing stored object by ID, updating its size, label, and retention window, paid per-call via HTTP 402 with no account required.","exampleAgentPrompt":"Overwrite the stored object with ID 'abc123' with my new checkpoint data using the medium plan, and keep the existing label.","exampleUseCases":[{"title":"Agent checkpoint state update","prompt":"Replace the contents of storage object 'ckpt-xyz789' with this updated state blob using the small plan — keep the label as-is."},{"title":"Rename and refresh stored result","prompt":"Overwrite storage object 'result-001' with the new output data, upgrade to the large plan so it fits, and rename the label to 'final-result'."},{"title":"Clear label on stored object","prompt":"Replace object 'temp-buf-55' with the revised buffer contents on the small plan and clear its label so it has no name anymore."}],"resultDescription":"Returns a JSON object with the object's ID, new expiry timestamp (Unix ms), previous expiry timestamp, new content size in bytes, previous content size, plan used, resulting label, and a payment receipt containing the payer wallet address, amount charged in atomic USDC units, network, and on-chain transaction hash.","failureModes":["Object ID not found — 404 if the object does not exist or has expired","Plan too small for new body — 402 response quoting the minimum required plan","Payment failure — 402 if provided payment is invalid or insufficient","Invalid plan enum value — 400 bad request","Label conflicts or malformed label parameter — 400 bad request"],"whenToPreferThis":"Use this endpoint when you already hold a valid storage object ID and need to overwrite its content with new data while preserving the same reference. It is preferable to deleting and re-creating when you need to keep the same ID or label stable. It also automatically extends retention to the longer of the old or new window, so replacing early never shortens your object's life. Ideal for agent checkpointing workflows where state must be updated in place.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:33:37.689Z","isFirstParty":false,"canonicalSlug":"agent-exec-storage-object-replace-9e26c5c0"}