MinIO icon

MinIO

MinIO operation

Overview

This node generates a presigned PUT URL for uploading an object to a MinIO bucket. A presigned PUT URL allows users or external systems to upload files directly to a specified bucket and key in MinIO without needing direct access to credentials. This is useful for securely allowing uploads from web clients, third-party services, or automation scripts.

Example scenarios:

  • Allowing users to upload profile images directly to your storage.
  • Enabling automated systems to upload logs or backups without exposing credentials.
  • Integrating with external partners who need to send files to your infrastructure.

Properties

Display Name Type Meaning
Bucket Resource Locator The target MinIO bucket where the file will be uploaded. Can be selected from a list or entered by name.
Key String The object key (path/filename) under which the uploaded file will be stored in the bucket.

Output

The node outputs a JSON object with the following structure:

{
  "url": "<presigned_put_url>"
}
  • url: The generated presigned PUT URL. Use this URL to upload a file directly to the specified bucket and key.

Dependencies

  • MinIO server: You must have access to a running MinIO instance.
  • API Credentials: Requires valid MinIO credentials configured in n8n as minioCredentialsApi.
  • n8n Configuration: No additional configuration required beyond credentials.

Troubleshooting

  • Missing Credentials:
    Error: No credentials got returned!
    Solution: Ensure that MinIO credentials are properly set up in n8n and assigned to the node.

  • Invalid Bucket or Key:
    If the specified bucket does not exist or the key is invalid, MinIO may return an error when using the presigned URL. Double-check the bucket and key values.

  • Operation Not Supported:
    Error: The operation "..." is not supported!
    Solution: Make sure you select a valid operation ("Presigned PUT URL") in the node configuration.

  • General Errors:
    Any other errors thrown during URL generation will be reported as node errors. Check the error message for details and verify your MinIO server status and permissions.

Links and References

Discussion