Buckets

ICBucket

ICPay Cloud guide

On-chain encrypted file storage

New bucketPricing
HomeWhat you getQuickstartTypeScript SDKPython SDKPublic CDN URLsVerify with curlMethod referenceAuthenticationBuckets — create, renew, update, deleteUpload — single call and chunked sessionsRead — CDN GET, download, list, searchWrite — update, move, copy, deleteTags and metadataBulk operationsAPI keysFile list pagination
ICBucket

On-chain encrypted file storage

Getting started

What you getQuickstart

Bucket SDK

TypeScript SDKPython SDK

CDN & URLs

Public CDN URLsVerify with curl

API reference

Method referenceAuthenticationBuckets — create, renew, update, deleteUpload — single call and chunked sessionsRead — CDN GET, download, list, searchWrite — update, move, copy, deleteTags and metadataBulk operationsAPI keysFile list pagination
ICPay

© 2026 ICPay. All rights reserved.

Products

  • ICFalcon
  • ICBucket
  • Canisters
  • Top up cycles
  • ICPay Wallet

Explore

  • Channels
  • Blog

Resources

  • Falcon CLI
  • ICP-Hub Packages
  • ICBucket Docs
  • Blog

Company

  • Charity
  • About
  • FAQ
  • Roadmap

Legal

  • Brands
  • Terms
  • Privacy
  • Transparency

Community

  • GitHub
  • X
  • LinkedIn
  • Discord
ICPayICPay
  • Blog
Buckets

ICBucket

ICPay Cloud guide

On-chain encrypted file storage

New bucketPricing
HomeWhat you getQuickstartTypeScript SDKPython SDKPublic CDN URLsVerify with curlMethod referenceAuthenticationBuckets — create, renew, update, deleteUpload — single call and chunked sessionsRead — CDN GET, download, list, searchWrite — update, move, copy, deleteTags and metadataBulk operationsAPI keysFile list pagination
ICBucket

On-chain encrypted file storage

Getting started

What you getQuickstart

Bucket SDK

TypeScript SDKPython SDK

CDN & URLs

Public CDN URLsVerify with curl

API reference

Method referenceAuthenticationBuckets — create, renew, update, deleteUpload — single call and chunked sessionsRead — CDN GET, download, list, searchWrite — update, move, copy, deleteTags and metadataBulk operationsAPI keysFile list pagination

API reference

Upload — single call and chunked sessions

Upload files up to 10 MB with automatic chunking for large payloads.

import { prepareUploadFile } from "@/lib/bucket/prepareUpload"
import { uploadChunkCount, readFileChunk } from "@/lib/bucket/uploadChunk"
import { storeFile } from "@/services/bucket/store-file"
import { getWalletActor } from "@/services/wallet"

const prepared = await prepareUploadFile(file)
await storeFile(identity, prepared.file, {
  bucketId: "icp",
  path: prepared.path,
  contentType: prepared.contentType,
  apiKey: "icp_cloud_…",
})

const actor = await getWalletActor(identity)
const begin = await actor.beginFileUpload(
  "icp", "/big.zip", "application/zip", BigInt(file.size), ["icp_cloud_…"]
)
if ("err" in begin) throw new Error(begin.err)
const uploadId = begin.ok
const total = uploadChunkCount(file.size)
for (let i = 0; i < total; i++) {
  const bytes = await readFileChunk(file, i, total)
  await actor.uploadFileChunkIndexed(uploadId, BigInt(i), bytes)
}
await actor.completeFileUpload(uploadId, ["icp_cloud_…"])

await actor.getUpload(uploadId)
await actor.cancelUpload(uploadId)
HomeWhat you getQuickstartTypeScript SDKPython SDKPublic CDN URLsVerify with curlMethod referenceAuthenticationBuckets — create, renew, update, deleteUpload — single call and chunked sessionsRead — CDN GET, download, list, searchWrite — update, move, copy, deleteTags and metadataBulk operationsAPI keysFile list pagination
HomeWhat you getQuickstartTypeScript SDKPython SDKPublic CDN URLsVerify with curlMethod referenceAuthenticationBuckets — create, renew, update, deleteUpload — single call and chunked sessionsRead — CDN GET, download, list, searchWrite — update, move, copy, deleteTags and metadataBulk operationsAPI keysFile list pagination
ICBucket

On-chain encrypted file storage

Getting started

What you getQuickstart

Bucket SDK

TypeScript SDKPython SDK

CDN & URLs

Public CDN URLsVerify with curl

API reference

Method referenceAuthenticationBuckets — create, renew, update, deleteUpload — single call and chunked sessionsRead — CDN GET, download, list, searchWrite — update, move, copy, deleteTags and metadataBulk operationsAPI keysFile list pagination