Upload a file
upload_fileUpload a local file to a bucket after validating its type and size, preventing overwrites, and returning the stored path.
Instructions
Upload a local file (image, video, audio, PDF, design asset) to a bucket. The file type and size are checked against the bucket's rules BEFORE uploading, so problems are caught early with a clear message. This NEVER overwrites: if a file with the same name already exists, the upload fails and asks for a different name. On success it returns the stored path, and for private buckets it reminds you to make a shareable link with 'get_signed_url'.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket | Yes | The bucket to upload into. Use 'list_buckets' to see options. | |
| content_type | No | Optional MIME type override, e.g. 'image/png'. Normally auto-detected from the extension. | |
| local_file_path | Yes | Full path to the file on this computer, e.g. C:/Users/me/Pictures/logo.png | |
| destination_path | No | Where to store it inside the bucket. Omit to use the file's own name. End with '/' to place it in a folder, e.g. 'logos/' stores it as logos/<filename>. |