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

Bucket SDK

TypeScript SDK

Install, client setup, and upload for icpay-bucket v1.2+.

Install

npm install icpay-bucket

Requires Node.js 18+.

Client

import { ICBucket } from "icpay-bucket"

const bucket = new ICBucket({
  bucketId: "your-bucket-id",
  apiKey: "your-api-key",
})

await bucket.uploadFile("logo.png", fileBuffer, {
  contentType: "image/png",
})

Result pattern

icpay-bucket v1.2+ returns Result<T> from every method — check ok / err before using the value.

On this page

InstallClientResult pattern
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