Skip to content
60+ cloud backends
Mount once, access forever
SHA256 integrity
File journal & history
Every file is a URL
Archive preview
Time-travel revisions
AI-native HTTP access
60+ cloud backends
Mount once, access forever
SHA256 integrity
File journal & history
Every file is a URL
Archive preview
Time-travel revisions
AI-native HTTP access
60+ cloud backends
Mount once, access forever
SHA256 integrity
File journal & history
Every file is a URL
Archive preview
Time-travel revisions
AI-native HTTP access
60+ cloud backends
Mount once, access forever
SHA256 integrity
File journal & history
Every file is a URL
Archive preview
Time-travel revisions
AI-native HTTP access
home / kit / files
FilesFILES

Every File Is a URL

One HTTP interface for local storage and 60+ cloud providers — Google Drive, S3, Dropbox, and more. Mount once, access forever.

View Documentation
hoody-files · universal storage access

$ FILES=abc123-def456-files-1.node-us-1.containers.hoody.com

# Google Drive

$ curl https://$FILES/api/v1/files/Work/report.pdf \

?backend=backend_drive_abc

# Amazon S3

$ curl https://$FILES/api/v1/files/backups/data.zip \

?backend=backend_s3_xyz

# Dropbox

$ curl https://$FILES/api/v1/files/Photos/vacation.jpg \

?backend=backend_dropbox_123

# same URL pattern

HTTP/1.1 200 OK

Content-Type: application/pdf

Content-Length: 524288

# different storage

HTTP/1.1 200 OK

Content-Type: application/zip

ETag: "a3f2bc..."

Same URL pattern. Different storage. No complexity.

home / kit / files / backends
60+ PROVIDERS

Connect Any Storage, Instantly

Mount Google Drive, S3, Dropbox, and 60+ providers in total. One authentication per backend, then access everything through a single HTTP interface.

Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
home / kit / files / protocols
FILE PROTOCOLS

Speak Every Storage Protocol

FTP, SFTP, SMB, WebDAV, HTTP, and HDFS — mount network storage using whatever protocol your infrastructure already speaks.

FTPport 21
SFTPport 22
SMBport 445
WebDAVNextcloud / SharePoint
HTTPweb file servers
HDFSHadoop clusters
home / kit / files / capabilities
CAPABILITIES

More Than File Hosting

Stream, hash, preview, zip, journal, and process images — capabilities that reach far past plain file hosting, all over one HTTP interface.

Read & Stream

Stream any file over HTTP from local storage or any mounted cloud backend. Supports HTML, JSON, and plain-text response formats.

GET /api/v1/files/{path}

SHA256 Integrity

Compute a SHA-256 digest of any file without downloading the full body. Critical for backup verification, deploy integrity checks, and compliance audits.

GET /api/v1/files/{path}?hash

Archive Preview

Inspect .tar.gz and .zip contents without extracting the archive. List entries, sizes, and paths instantly.

GET /{archive}?preview

Directory as .zip

Download any directory as a streaming .zip archive on demand. Works for local storage and remote cloud backends alike.

GET /{directory}?zip

File Journal & History

Every mutation is recorded with a content-addressable blob snapshot. Read any file at any past revision or timestamp, and diff between versions.

GET /api/v1/files/{path}?history

Image Processing

On-the-fly resize, format conversion, blur, and grayscale for JPEG, PNG, WebP, GIF, and BMP — from any storage backend.

GET /{image}?thumbnail&width=400
home / kit / files / api
API REFERENCE

25 Endpoints. One Interface.

Read, write, manage backends, and monitor the journal — everything exposed as plain HTTP. No SDK required.

25 endpoints

Read & Download

7 endpoints

GET https://abc123-def456-files-1.node-us-1.containers.hoody.com/api/v1/files/Work/report.pdf?hash → 200 OK

GET
/{path}List directory contents or download a file
GET
/api/v1/files/{path}Richer v1 form with full search and journal access
HEAD
/{path}Get file metadata without downloading the body
GET
/api/v1/files/{path}?hashReturn the SHA-256 digest of a file
GET
/api/v1/files/glob/{path}Find files by glob pattern
GET
/api/v1/files/grep/{path}Search file contents with grep
GET
/api/v1/files/stat/{path}Get file metadata via stat

Write & Mutate

6 endpoints

POST https://abc123-def456-files-1.node-us-1.containers.hoody.com/api/v1/files/copy/notes.md?copy_to=/backup/ → 200 OK

PUT
/{path}Upload a file to storage
PATCH
/{path}Modify file properties, or move and rename
DELETE
/{path}Delete a file or directory
POST
/api/v1/files/copy/{path}Copy a file or directory to a new location
POST
/api/v1/files/move/{path}Move or rename a file or directory
POST
/api/v1/files/{path}File operations: mkdir, extract, download

Backend Management

6 endpoints

POST https://abc123-def456-files-1.node-us-1.containers.hoody.com/api/v1/backends/drive → { "id": "backend_drive_abc" }

GET
/api/v1/backendsList all connected backends
POST
/api/v1/backends/{type}Connect a storage backend by type
GET
/api/v1/backends/{id}Get backend details
PUT
/api/v1/backends/{id}Update backend credentials
DELETE
/api/v1/backends/{id}Disconnect a backend
GET
/api/v1/backends/{id}/testTest a backend connection

System & Journal

6 endpoints

GET https://abc123-def456-files-1.node-us-1.containers.hoody.com/api/v1/journal?path=src/&op=write → 200 OK

GET
/api/v1/files/healthService health check
GET
/api/v1/journalQuery file mutation journal entries
POST
/api/v1/journal/flushFlush the journal to disk
GET
/api/v1/journal/statsGet journal statistics
GET
/api/v1/downloadsList active downloads
GET
/api/v1/extractionsList active extractions
home / kit / files / backends-matrix
BACKEND TYPES

Four Backend Categories

Four categories of storage, one HTTP interface. Mount any combination and access them all through the same URL pattern.

Category
Providers
Mount Type
Auth Method
Cloud Storage
Google Drive, Dropbox, OneDrive, Box, iCloud Drive, MEGA, and more
Virtual filesystem
OAuth / API Key
Object Storage
Amazon S3, Azure Blob, Google Cloud Storage, Backblaze B2, Cloudflare R2, and S3-compatible
Bucket path
IAM / Access Key
File Protocols
FTP, SFTP, SMB, WebDAV, HTTP, HDFS
Network path
Password / Key / Anonymous
Special
Cache, Chunker, Combine, Crypt, Compress
Layered
Inherits from wrapped backend
home / kit / files / start

Every File Is a URL

Start reading, hashing, and managing files across 60+ providers with one HTTP interface. Files is bundled with every Hoody container.

Read the Docs