{"uid":"cap_F1BnXUfsx5ScV8eDRsVcy","slug":"agent-exec-storage-object-renewal-900af2ca","name":"agent-exec Storage Object Renewal","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.org/storage/%7Bid%7D/renew?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"plan":{"enum":["small","medium","large","year"],"type":"string","description":"Optional. Which plan to buy. Its retention window is ADDED to whatever the object has left, never substituted for it, so renewing early forfeits nothing. Omitted, misspelled or too small for the object, you get the smallest plan that holds the object, and the 402 quotes exactly that."}}},"responseSchema":{"type":"object","required":["id","expiresAt","previousExpiresAt","plan","payment"],"properties":{"id":{"type":"string"},"note":{"type":"object","properties":{"code":{"enum":["STORAGE_RENEWAL_PLAN_TOO_SMALL"],"type":"string"},"details":{"type":"object"},"message":{"type":"string"}},"description":"Present only when this plan's byte allowance did not cover the object's actual size. Informational, not a refusal: the renewal above still happened, for exactly what was paid."},"plan":{"enum":["small","medium","large","year"],"type":"string"},"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 renewal."},"previousExpiresAt":{"type":"integer","description":"Unix ms the object would have expired before this renewal."}}},"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_t_OVLneB_DFkJqdEaz3ne","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":"Renews the retention window of a stored object in the agent-exec sandbox by paying per-use via HTTP 402, extending its expiry without losing existing time.","exampleAgentPrompt":"Renew the agent-exec storage object with ID abc123 on the medium plan so it doesn't expire — go ahead and pay the USDC fee.","exampleUseCases":[{"title":"Keep sandbox output accessible longer","prompt":"My agent-exec storage object ID is xyz789 and it's about to expire — renew it on the large plan so we have more time to process the results."},{"title":"Auto-renew before expiry in a pipeline","prompt":"Before we continue the workflow, renew the agent-exec stored object def456 using the small plan and confirm how long it's valid now."},{"title":"Preserve intermediate computation result","prompt":"I ran some code in agent-exec earlier and the output is stored as object id qrs321 — extend its retention with a medium plan so I can retrieve it later today."}],"resultDescription":"Returns the object's new expiry timestamp (Unix ms), the previous expiry timestamp, the plan used, the object ID, and payment details including the payer wallet address, amount charged in atomic USDC units, network, and on-chain transaction hash.","failureModes":["Object ID not found or already freed — 404 response","Insufficient payment or payment rejected — 402 response with correct pricing","Invalid plan enum value — validation error","Plan specified is too small for the object's current size — automatically upgraded to the smallest valid plan","Payment network or wallet issues causing transaction failure"],"whenToPreferThis":"Use this endpoint when you have an existing stored object in agent-exec that is approaching expiry and you want to extend its retention window without losing any remaining time. Ideal for long-running agent pipelines where intermediate results need to be preserved across steps, or when you want to pay only for additional storage time on demand without committing to an account or subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:35:05.704Z","isFirstParty":false,"canonicalSlug":"agent-exec-storage-object-renewal-900af2ca"}