Docs
Short notes on the parts people actually ask about. If something is missing, ask on the forum — we add pages when the same question shows up twice.
Quotas
Every member gets 10 GB. The quota is shared across uploads and attachments, and it counts the stored size, not the original file size — deduplicated blocks are charged once.
- Deleting a file frees the quota immediately.
- Trash is kept for 30 days and still counts against the quota.
- Going over the quota blocks new uploads, never reads.
Sync
The Hub keeps an append-only event log. Clients send a cursor and get everything after it, so a reconnect does not require a full resync.
- Retention: 30 days of events.
- Cursor is opaque — do not parse it.
- A cursor older than the retention window returns
410and the client starts over.
Sessions
A session belongs to a member, not to a device. Logging in from a second machine does not invalidate the first; it adds a device to the same session record.
Sessions survive a Hub restart. They do not survive a member being disabled — that cancels every device at once.
API
The API is versioned under /api/v1/ and speaks JSON. Authentication is a bearer token issued at login. Rate limits are per member and per IP, whichever is reached first.
GET /api/v1/me— account and quotaGET /api/v1/events?cursor=…— sync streamPOST /api/v1/upload— direct upload, resumable
Errors use a consistent shape: {"ok":false,"error":{"code":"…","message":"…"}}.