Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt

Use this file to discover all available pages before exploring further.

The File Upload node uploads files to file input fields on web pages. To use it, supply a signed download URL pointing to the file as the signed_file_url parameter — CloudCruise fetches the file from that URL at execution time and uploads it to the page. The URL can come from any storage provider (S3, GCS, Azure Blob, etc.) as long as it is publicly retrievable via GET without additional authentication. The node assumes that the system-level file upload dialog is already opened — add a Click node on the file input trigger before this node.

Parameters

ParameterTypeRequiredDescription
signed_file_urlstringYesSigned URL pointing to the file to upload
file_namestringNoCustom file name (including extension) to use when uploading. If not provided, a unique name is generated automatically.

Examples

Basic File Upload

Upload a file using a signed URL:
{
  "id": "abc123",
  "name": "Upload document",
  "action": "FILE_UPLOAD",
  "parameters": {
    "signed_file_url": "{{context.inputs.file_url}}"
  }
}

File Upload with Custom Name

Upload a file with a specific file name:
{
  "id": "abc123",
  "name": "Upload resume",
  "action": "FILE_UPLOAD",
  "parameters": {
    "signed_file_url": "{{context.inputs.file_url}}",
    "file_name": "resume.pdf"
  }
}
You can also use variables for the file name:
{
  "id": "abc123",
  "name": "Upload document",
  "action": "FILE_UPLOAD",
  "parameters": {
    "signed_file_url": "{{context.inputs.file_url}}",
    "file_name": "{{context.inputs.file_name}}"
  }
}

Notes

  • When using file uploads, include the file URL in your workflow inputs
  • The file must be accessible via a signed URL (pre-authenticated URL)
  • The file node assumes that the system-level file upload dialog is already opened. Add a click node before the file upload node to trigger this.
  • Common file types like PDFs, images, and documents are supported
  • For multiple file uploads, use a Loop node that loops over an array of file URLs
  • Use file_name when the target website validates or displays the uploaded file name (found under Advanced settings in the workflow editor)