Rankion OS — Storage & Files

Rankion OS is the platform-wide file and asset layer. Instead of running each module with its own upload path, everything comes together here: images from the AI Content Editor, generated artwork, reports, manual uploads, shared team assets. OS provides a file hierarchy with folders, Spotlight search, a Desktop view for quick access, and granular sharing. The module is team-scoped and behaves like a lightweight macOS / Drive hybrid with API-first access.

What it can do

• Files & folders — arbitrarily deep folder hierarchy per team. Files can be moved, shared, renamed, deleted.
• Move operations — move file or folder to another folder via the move endpoint. Permissions are inherited.
• Sharing — sharing a file creates a public-or-team-scoped share link. Revoke via DELETE.
• Desktop view — GET /os/desktop returns the quick-access items (pinned, recents, shared with me).
• Spotlight search — GET /os/spotlight?q=... searches filenames and metadata team-wide.
• Mode & preferences — PUT /os/mode switches between UI modes (e.g. list/grid). preferences persists per-user settings (sort, view, pinned).
• Trash — deleted files land in trash and are recoverable until final purge.

When to use

• You need a central location for team assets that isn't hidden inside individual modules.
• You want to reuse generated images from the Images module in another article or report.
• You want to persistently store reports or exports instead of losing them after download.
• You want to share a file with an external reviewer without bringing them into the team.

Workflow

1. Create folder structure — POST /os/folders with {name, parent_id?}. Root folder without parent_id.
2. Upload file — POST /os/files with multipart body (file, folder_id?, name?). Response returns id, url, mime, size.
3. Move — POST /os/files/{id}/move with {folder_id}. Folder analogously POST /os/folders/{id}/move.
4. Share — POST /os/files/{id}/share creates a share token. DELETE /os/files/{id}/share revokes it.
5. Search — GET /os/spotlight?q=report or use Desktop quick access.
6. Delete — DELETE /os/files/{id} moves to trash. Hard delete happens per quota / retention policy.

API

Example — upload file.

curl -X POST $BASE/os/files \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@./report-april.pdf" \
  -F "folder_id=12"

Example — Spotlight.

curl "$BASE/os/spotlight?q=report" -H "Authorization: Bearer $TOKEN"

Credits & Limits

• Free — storage operations cost no credits.
• Quota — each team has a storage limit (see plan / settings). Upload past quota: 413 or 422 with quota_exceeded.
• MIME whitelist — common image, document, CSV, PDF, Markdown formats. Executables are rejected.
• Max file size — typically 50 MB per file (plan-dependent).
• Sharing — public share links are token-based, optionally with expiry. Lost token = revoke and create a new one.

Related modules

• AI Content Editor — article featured images and inline images are stored in OS.
• Images — generated AI images land automatically in OS and remain reusable there.
• Blog Admin — featured images for blog posts come from OS.