Cancel Walrus storage renewal

/v4/data/storage/upload/{jobId}

Soft cancel: 0 credits. Instant delete: billed via Walrus on-chain storage fees (same credit check as upload).

Cancel renewal for a certified Walrus storage upload. Two modes are available:

  • Soft cancel (default, instant=false): marks the blob as noRenewal=true. The file remains on-chain until its current storage epoch expires (walrusEndEpoch), then decommissions naturally. No additional fee is incurred — the remaining prepaid epochs are simply not renewed.
  • Instant delete (instant=true): queues an immediate on-chain delete transaction. Requires sufficient Walrus storage credits (same check as upload). The Walrus worker executes the delete tx and the on-chain delete fee is charged to your Walrus storage balance afterward. Can be applied even if soft cancel was already set — it upgrades to instant.

Both modes are idempotent. The job must be in CERTIFIED status and not already decommissioned.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The job ID returned by POST /v4/data/storage/upload.

Query Params
boolean
Defaults to false

Set to true to queue an immediate on-chain delete (costs Walrus storage credits). Omit or set to false (default) for a free soft cancel — blob stays on-chain until its epoch expires.

Responses

404

Upload job not found or does not belong to this API key.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json