API Changelog

Breaking changes are marked [breaking]. All other changes are additive and backwards-compatible.

2026-05-11 — v1 public launch

New endpoints

• GET /api/v1/files — list files with pagination, filtering, and search
• GET /api/v1/files/:id — fetch a single file by ID
• PATCH /api/v1/files — update file metadata (tags, description, visibility)
• DELETE /api/v1/files/:id — soft-delete a file
• POST /api/v1/upload — upload a file via multipart form
• GET /api/v1/stats — usage statistics with daily breakdown
• GET /api/v1/transform — on-the-fly image transforms (beta)
• GET /api/v1/folders — list folders with optional ?parentId filter
• POST /api/v1/folders — create a folder
• GET /api/v1/folders/:id — fetch a folder with its immediate children
• PATCH /api/v1/folders/:id — rename or move a folder
• DELETE /api/v1/folders/:id — delete a folder

Authentication

• API keys authenticated via X-API-Key header
• Keys prefixed with mn_; hashed at rest

Rate limiting

• X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset headers on all responses
• Daily window, resets at midnight UTC