{"uid":"cap_CshBrpXoXTssjrP-Mz0rk","slug":"munition-upload-renew-0ea6ae54","name":"Munition Upload Renew","description":"Munition Upload Renew: x402-paid renewal for an existing direct-upload file. Pay 0.005 USDC to extend the public file link by 7 days, up to 30 days from the original upload time.","url":"https://api.munition.io/v1/uploads/:id/renew","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string","description":"Existing Munition direct-upload id to renew. This value is passed in the URL path: /v1/uploads/{id}/renew."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iT3VPbx9Dz7bjgqIOc3qC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extends the public link of an existing Munition-hosted file by 7 days (up to 30 days from original upload) for 0.005 USDC via x402 payment.","exampleAgentPrompt":"Renew my Munition upload with ID 'upl_abc123xyz' so the public link stays active for another 7 days — pay the 0.005 USDC renewal fee.","exampleUseCases":[{"title":"Keep shared report link alive","prompt":"I shared a report file via Munition and the link is about to expire — renew upload ID 'upl_r7k2m9qp' so collaborators can still access it for another week."},{"title":"Extend agent-generated artifact hosting","prompt":"My agent just finished generating a file and stored it on Munition with ID 'upl_88ztf4lx', but I need the link to stay public for a bit longer — go ahead and renew it."},{"title":"Refresh temporary asset before client delivery","prompt":"I'm sending a client a file I uploaded to Munition yesterday with ID 'upl_9ynq03dv', but I want to make sure the link won't expire before they open it — please renew it now."}],"resultDescription":"Returns a confirmation that the file's public link has been extended by 7 days, along with the updated expiry timestamp. The link remains the same; only the expiration window is pushed forward. Total extension is capped at 30 days from the original upload time.","failureModes":["Upload ID not found — returns 404 if the specified upload ID does not exist","Renewal cap exceeded — returns an error if extending would push the expiry beyond 30 days from original upload","Insufficient payment — x402 payment of 0.005 USDC not completed or rejected","Already expired — file link has already expired and cannot be renewed","Malformed ID — upload ID is not in the expected format"],"whenToPreferThis":"Use this endpoint when you have an existing Munition direct-upload file whose public link is approaching expiry and you want to extend it without re-uploading. It is the only way to extend a Munition upload link without creating a new upload slot. Prefer this over re-uploading when the file is already accessible at its current URL and you want to preserve that link.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:40:52.841Z","isFirstParty":false}