Storage API
Personal media storage with folder hierarchy, file upload, previews, sharing links, API access keys, and per-user quota controls.
Base URL
https://storage.ampersand-it.com/Key Features
Nested folders with create, rename, move, and delete operations.
Upload and replace files up to configured limits.
Public/Private visibility with direct media link and UI page link.
Optional password and API access key protection for public access.
Workspace and folder usage tracking with user quotas.
Admin mode to inspect and manage user storage contexts.
Authentication
Private API endpoints require authenticated cookie session.
Public endpoints are available without authentication, but can require password/key.
Main Endpoints
GET /api/storage/folders
POST /api/storage/folders
PUT /api/storage/folders/{folderId}/rename
PUT /api/storage/folders/{folderId}/move
DELETE /api/storage/folders/{folderId}
GET /api/storage/files/{folderId}
POST /api/storage/files/upload/{folderId}
POST /api/storage/files/{fileId}/replace
POST /api/storage/files/{fileId}/move
DELETE /api/storage/files/{fileId}
GET /api/storage/files/{fileId}/details
GET /api/storage/files/{fileId}/content
GET /api/storage/files/{fileId}/thumbnail
POST /api/storage/files/{fileId}/visibility
POST /api/storage/files/{fileId}/password
POST /api/storage/files/{fileId}/access-key
POST /api/storage/files/{fileId}/access-key/generate
POST /api/storage/files/{fileId}/public-link
POST /api/storage/files/{fileId}/public-link/regenerate
GET /api/storage/usage
GET /api/storage/usage/folder/{folderId}
GET /api/storage/export/{folderId}
GET /api/storage/settings/quota
POST /api/storage/settings/quota
POST /api/storage/public/verify/{mode}/{token}
GET /api/storage/public/media/{token}
GET /api/storage/public/private/{fileId}?key={accessKey}
GET /public/file/{token}
GET /public/media/{token}
GET /api/admin/storage/check
GET /api/admin/storage/usersUsage Examples
# Get root folders list
curl -X GET "https://storage.ampersand-it.com/api/storage/folders" \
-H "Cookie: your_auth_cookie"
# Upload file to folder
curl -X POST "https://storage.ampersand-it.com/api/storage/files/upload/{folderId}" \
-H "Cookie: your_auth_cookie" \
-F "file=@photo.jpg"
# Access direct public media with key
curl -X GET "https://storage.ampersand-it.com/api/storage/public/media/{token}?accessKey=YOUR_KEY"© 2026 Ampersand Documentation