AlphaDrive REST API Reference

AlphaDrive provides a clean, JSON-based REST API for programmatic access, client automation, and integration.

---

Authentication & Headers

• Session Cookie: alphadrive_session=<token> (HTTP-only, SameSite=Lax).
• CSRF Header: For state-changing requests (POST, DELETE, PUT), include: X-CSRF-Token: <csrf_token>

---

API Endpoints

1. User & Account

• GET /api/me Returns authenticated user details and storage quota.
• POST /api/account/username Change personal username ({ "new_username": "..." }).
• POST /api/account/password Change password ({ "current_password": "...", "new_password": "..." }).
• POST /api/account/users (Admin only) — Create new user ({ "username": "...", "name": "...", "password": "...", "is_admin": bool }).

2. Files & Folders

• GET /api/nodes?parent_id=<id> List active files and folders inside a directory.
• GET /api/nodes/trash List items currently in trash.
• GET /api/nodes/{id} Get metadata for a specific item.
• POST /api/nodes/folder Create a new folder ({ "name": "...", "parent_id": "..." }).
• POST /api/nodes/trash Move items to trash ({ "ids": ["id1", "id2"] }).
• POST /api/nodes/restore Restore items from trash ({ "ids": ["id1", "id2"] }).
• DELETE /api/nodes Permanently delete items ({ "ids": ["id1", "id2"] }).

3. File Transfers & Streaming

• POST /api/upload Multi-part file upload (file, parent_id, relative_path).
• GET /api/files/{id}/view Stream file content for browser preview (Supports Range headers).
• GET /api/files/{id}/download Download file attachment.
• GET /api/folders/{id}/download Download folder contents as a streamed ZIP archive.

4. Public Shares

• GET /api/nodes/{id}/share Get active share status for an item.
• POST /api/shares Create a public share link ({ "node_id": "...", "custom_slug": "...", "password": "...", "expires_in": "24h" }).
• DELETE /api/shares/{id} Revoke an active public share link.
• GET /s/{slug} Public share web page.
• POST /s/{slug}/unlock Unlock password-protected public share.
• GET /s/{slug}/files/{id}/view Public preview stream.
• GET /s/{slug}/files/{id}/download Public file download.
• GET /s/{slug}/download Public folder ZIP stream.