file

File - File Upload and Management

Overview

Manage file uploads and downloads in VibeSurf. Upload files to workspace directories, download files by ID or path, and list uploaded files.

When to Use

• User wants to upload files to VibeSurf
• User wants to download files from VibeSurf
• User wants to list uploaded files
• User wants to browse session files
• User needs to manage file storage

API Endpoints

Base path: $VIBESURF_ENDPOINT/api/files

Action	Method	Endpoint	Description
Upload Files	POST	/api/files/upload	Upload files to workspace
Download File	GET	/api/files/download?file_id={id}	Download file by ID or path
List Files	GET	/api/files	List all uploaded files
List Session Files	GET	/api/files/session/{session_id}	List files in a session directory

Request Examples

Upload Files

curl -X POST "$VIBESURF_ENDPOINT/api/files/upload" \
  -F "files=@/path/to/file1.pdf" \
  -F "files=@/path/to/file2.jpg" \
  -F "session_id=optional-session-id"

Response:

{
  "message": "Successfully uploaded 2 files",
  "files": [
    {
      "file_id": "uuid-string",
      "original_filename": "file1.pdf",
      "stored_filename": "file1.pdf",
      "session_id": null,
      "file_size": 12345,
      "mime_type": "application/pdf",
      "upload_time": "2026-02-08T12:00:00",
      "file_path": "/path/to/file"
    }
  ],
  "upload_directory": "/workspace/sessions/upload_files"
}

Download File by ID

curl -X GET "$VIBESURF_ENDPOINT/api/files/download?file_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  -o downloaded_file.pdf

Download File by Path (Absolute or Relative)

Using absolute path (preferred for direct file access):

curl -X GET "$VIBESURF_ENDPOINT/api/files/download?file_path=/workspace/sessions/upload_files/myfile.pdf" \
  -o downloaded_file.pdf

Using relative path from workspace:

curl -X GET "$VIBESURF_ENDPOINT/api/files/download?file_path=sessions/upload_files/myfile.pdf" \
  -o downloaded_file.pdf