Skip to content
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.

hoody-files · universal storage access

# Google Drive

$ curl /api/v1/files/Work/report.pdf \

?backend=backend_drive_abc

# Amazon S3

$ curl /api/v1/files/backups/data.zip \

?backend=backend_s3_xyz

# Dropbox

$ curl /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+ more providers. 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 — all through a single HTTP interface that works across every backend.

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 SHA256 or MD5 hashes without downloading the full file. Critical for production deployments, backup verification, and compliance.

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 /[path]?preview

Directory as .zip

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

GET /[path]?zip

File Journal & History

Every mutation is recorded with a content-addressable blob snapshot. Read any file at any past revision or timestamp, 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

21 Endpoints. One Interface.

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

Read & Download

[count, plural, =1 [# endpoint] other [# endpoints]]'

curl .../api/v1/files/Work/report.pdf?backend=backend_drive

GET
/api/v1/files/[path]Read or download file content
GET
/[path]Alternative with HTML/JSON/simple formats
HEAD
/api/v1/files/[path]Get metadata without downloading
GET
/api/v1/files/[path]?hashGet SHA256 hash of file
GET
/[path]?previewPreview archive contents (tar.gz, zip)
GET
/[path]?zipDownload directory as .zip archive

Write & Mutate

[count, plural, =1 [# endpoint] other [# endpoints]]'

POST .../api/v1/files/copy/[path]?copy_to=/backup/

PUT
/[path]Upload a file to server storage
POST
/api/v1/files/[path]File operations: mkdir, extract, move, copy
POST
/api/v1/files/copy/[path]Copy file or directory to new location
POST
/api/v1/files/move/[path]Move or rename file to new path
DELETE
/[path]Delete a file or directory
GET
/[directory]?qSearch for files matching a query

Backend Management

[count, plural, =1 [# endpoint] other [# endpoints]]'

POST .../api/v1/backends/drive → [id: "backend_drive_abc"]

POST
/api/v1/backends/[type]Mount a storage backend
GET
/api/v1/backendsList all mounted backends
GET
/api/v1/backends/[id]Get backend details
GET
/api/v1/backends/[id]/testTest backend connection
DELETE
/api/v1/backends/[id]Disconnect backend

System & Journal

[count, plural, =1 [# endpoint] other [# endpoints]]'

GET .../api/v1/journal?path=src/&op=write

GET
/__hoody-files__/healthService health status
GET
/api/v1/downloadsList active downloads
GET
/api/v1/extractionsList active extractions
GET
/api/v1/journalQuery file mutation journal
home / kit / files / backends-matrix
BACKEND TYPES

Every Backend Category

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
31 providers incl. Google Drive, Dropbox, OneDrive, Box
Virtual filesystem
OAuth / API Key
Object Storage
S3, Azure Blob, GCS, B2, Cloudflare R2, and 25+ 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