Skip to main contentSkip to navigation

Beta Testing: WormHole is currently in private beta. We're inviting a limited number of users to test for free.

REST API • TypeScript SDK • OpenAPI 3.1

Build with
AI-Powered Storage

The file storage API that actually respects developers. 2-minute setup, AI features built-in, end-to-end encryption by default.

<2 min
to first API call
100%
E2E encrypted
Free
AI auto-tagging
Quickstart
# Install SDK
npm install @wormhole/sdk

# Make your first request
curl https://api.wormhole.cloud/v1/files \
  -H "Authorization: Bearer wh_live_your_key"

Why developers switch

Google Drive & Dropbox APIs were built in 2012. We built ours for 2025.

FeatureGoogle DriveDropboxWormHole
Time to First API Call30+ min20+ min< 2 min
AI-Powered Search
Document Q&A API
Auto-Tagging
E2E Encryption
OpenAPI 3.1 SpecPartial
Interactive Playground
Request Logs UI
Webhook HMAC Signatures
Breaking Change PolicyNone6 months12 months
SDK Auto-GenerationManualManualOpenAPI

Everything you need

Built by developers, for developers. No enterprise sales call required.

AI Features Built-In

Semantic search, document Q&A, auto-tagging, and summarization. No separate AI API needed.

E2E Encryption Default

One line of code: encrypt: true. Files encrypted before upload, keys never leave the client.

Interactive Playground

Test every endpoint in your browser. Auto-generates code in TypeScript, Python, and cURL.

Real-Time Webhooks

8 event types with HMAC signatures. Know when files upload, share, delete, or AI analysis completes.

OpenAPI 3.1 Spec

Generate SDKs in any language. Import to Swagger, Redoc, or your API gateway.

Health & Monitoring

/api/health endpoint for uptime monitoring. Service status, latency metrics, all included.

TypeScript SDK

Full-featured SDK with TypeScript support. Upload files, search with AI, encrypt data, and manage webhooks — all type-safe.

File upload with progress tracking
AI-powered semantic search
Document Q&A and summarization
Automatic retry with exponential backoff
End-to-end encryption helpers
index.ts
import { WormHoleSDK } from '@wormhole/sdk';

const wormhole = new WormHoleSDK({ 
  apiKey: process.env.WORMHOLE_API_KEY 
});

// Upload with AI auto-tagging
const file = await wormhole.uploadFile(document, {
  autoTag: true,
  encrypt: true,
});

// Natural language search
const results = await wormhole.aiSearch(
  "find all contracts from Q4 2024"
);

// Ask questions about documents
const answer = await wormhole.askDocument(
  fileId, 
  "What is the contract value?"
);
// → { answer: "$2.5 million", confidence: 0.94 }

Start in 2 minutes

No enterprise sales call. No OAuth setup hell. Just get your key and start building.

1

Get API Key

Sign up and grab your API key from the Developer Portal. Takes 30 seconds.

2

Install SDK

npm install @wormhole/sdk — or use our REST API directly with any HTTP client.

3

Ship It

Upload files, search with AI, encrypt data. All the features, none of the complexity.

Real-time webhooks

Get notified instantly when files are uploaded, shared, deleted, or when AI analysis completes. Every webhook is signed with HMAC-SHA256.

file.uploaded — New file added
file.shared — Share link created
file.deleted — File removed
ai.analysis.complete — AI finished processing
snapshot.created — Time-travel backup made
Webhook Payload
// Webhook payload
{
  "event": "file.uploaded",
  "timestamp": "2025-01-01T00:00:00Z",
  "data": {
    "file_id": "file_abc123",
    "file_name": "contract.pdf",
    "tags": ["contract", "legal", "Q4"],
    "ai_summary": "Q4 vendor agreement..."
  },
  "signature": "sha256=abc123..."
}

Ready to build something amazing?

Get your API key in 30 seconds. No credit card, no sales call, no BS.

100 requests/hour free • Full AI features • E2E encryption included