/v4/data/storage/upload
Billed via Walrus on-chain storage fees — no standard API credits consumed per call.
Upload a file to Walrus decentralized storage.
Files are staged in GCS and then certified on-chain by the Walrus worker asynchronously.
The response immediately returns a jobId and a pre-computed blobId;
poll GET /v4/data/storage/upload/{jobId} to track certification progress.
Epochs and renewals: Walrus storage is divided into epochs (approximately 2 weeks each).
Files are stored for the platform default of ~4 epochs (~8 weeks) and are automatically renewed
by Tatum before each epoch window closes. Renewal fees (SUI/WAL on-chain costs × your plan rate)
are charged to your Walrus storage balance. To stop automatic renewal, call
DELETE /v4/data/storage/upload/{jobId}.
- Maximum file size: 50 MiB.
- Only available on mainnet API keys.
- If another active upload already exists with the same filename and size, the filename is
automatically disambiguated (e.g.
report (1).pdf) to avoid blob-id collisions on-chain. - Send the file as a
multipart/form-datafield namedfile.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||