DragDropDo

Complete Upload

Finalize an upload after the file has been PUT to the presigned URL. You MUST call this after the PUT succeeds, or the file will not be usable. Pass all values from initiate_upload (file_key, upload_id, object_name) plus the parts array. For a single-part upload: parts should be [{"etag": "<ETag from PUT response>", "part_number": 1}]. The ETag is in the PUT response headers, e.g. 'ETag: "abc123"' — include the quotes as returned. Returns JSON: {message: string}.

Compress File

Compress files to reduce their size. Supports PDF, images, and other file types. Compression levels: 'recommended' (balanced quality/size), 'high' (smallest file, lower quality), 'low' (minimal compression, highest quality). Use supported_operation with ext and action='compress' to check available compression levels for a specific extension. Returns a main_task_id — poll with poll_status to get download links when compression completes. Returns JSON: {main_task_id: string}.

Convert File

Convert files from one format to another. Supports a wide range of conversions: PDF to PNG/JPG/DOCX/XLSX, DOCX to PDF, JPG/PNG/WEBP between each other, MP4 to MP3, and many more. Use supported_operation with ext='pdf' action='convert' to discover all valid convert_to targets for a specific extension. Returns a main_task_id — poll with poll_status to get download links when conversion completes. Returns JSON: {main_task_id: string}.

Get Download Link

Resolve a file_key to a short-lived presigned URL for downloading the object from MinIO (same response shape as GET /v1/download/:file_key). Use the output file_key from poll_status after an operation completes, or an input file_key after complete_upload. The presigned_url expires in about 15 minutes — use curl/HTTP GET to fetch bytes. Returns JSON: {presigned_url: string, download_name: string}.

Get Status

Check the current status of a file operation. Use the main_task_id returned by any operation tool (convert_file, compress_file, merge_files, etc.). Possible operation_status values: 'queued', 'running', 'completed', 'failed'. When completed, files_data contains download_link for each processed file. For a single check use this tool; to wait until completion, use poll_status instead. Returns JSON: {operation_status: string, notes: object, files_data: [{file_key, status, download_link?, error_code

Initiate Upload

Get a presigned URL to upload a file directly to D3 storage. 3-step flow: Step 1: Call this tool with file metadata → returns a presigned_url. Step 2: HTTP PUT the entire file to that URL: 'curl -s -D- -X PUT -H "Content-Type: <mime_type>" --upload-file <local_file> "<presigned_url>"'. Grab the ETag from the response headers (look for 'ETag: "..."'). Step 3: Call complete_upload with file_key, upload_id, object_name, and parts: [{etag: "<etag>", part_number: 1}]. Always use parts=1 (default). A

Lock Pdf

Protect PDF files with a password. The output PDF will require the password to open. Only works with PDF files. Returns a main_task_id — poll with poll_status to get the download link for the locked PDF. Returns JSON: {main_task_id: string}.

Merge Files

Merge multiple files into a single file. Most commonly used to merge multiple PDFs into one. The order of file_keys determines page order in the merged output. Requires at least 2 file_keys. Returns a main_task_id — poll with poll_status to get the download link when merge completes. Returns JSON: {main_task_id: string}.

Poll Status

Wait for an operation to complete by polling its status repeatedly. Blocks until the operation reaches 'completed' or 'failed', or until timeout. Preferred over calling get_status in a loop — this tool handles the waiting internally. Returns the final status with download links when completed. Returns JSON: {operation_status: string, notes: object, files_data: [{file_key, status, download_link?, error_code?, error_message?}]}.

Reset Pdf Password

Change the password on a password-protected PDF. You must know the current (old) password. Only works with password-protected PDF files. Returns a main_task_id — poll with poll_status to get the download link for the re-protected PDF. Returns JSON: {main_task_id: string}.

Supported Operation

Check what file operations are supported for a given extension BEFORE attempting an operation. Three modes: (1) Pass only 'ext' to list all available actions for that extension. (2) Pass 'ext' + 'action' to check if a specific action is supported and get its parameter options (e.g. available compression levels, or valid convert_to targets). (3) Pass 'ext' + 'action' + specific parameter values to validate them. Always call this tool first if you are unsure whether an operation or format is suppo

Unlock Pdf

Remove password protection from PDF files. You must know the current password. Only works with password-protected PDF files. Returns a main_task_id — poll with poll_status to get the download link for the unlocked PDF. Returns JSON: {main_task_id: string}.

Zip Files

Create a ZIP archive from one or more uploaded files. Returns a main_task_id — poll with poll_status to get the download link for the ZIP file. Returns JSON: {main_task_id: string}.