1001fx - NoCode functionsInstall

Overview

The "Upload an Asset" operation in the files resource of the 1001fx n8n node allows users to upload a file (asset) for processing via the 1001fx API. This is useful in automation workflows where you need to send files—such as images, documents, or other assets—to external services for further manipulation, storage, or analysis.

Common scenarios:

• Automating the upload of user-submitted files to a cloud service.
• Integrating with document management systems that require asset ingestion.
• Pre-processing files before passing them to other workflow steps.

Practical example:
A company receives invoices as PDFs via email. Using n8n, they can automatically extract the PDF attachment and use this node to upload it to 1001fx for further processing, such as OCR or archiving.

Properties

• Asset file: The file you want to upload. In n8n, this typically refers to a binary property from a previous node (e.g., a file downloaded or received as an email attachment).

Output

• The output is a JSON object containing the response from the 1001fx API after uploading the asset.
• The structure of the output depends on the API's response. Typically, it may include fields such as:
  • id: Identifier for the uploaded asset.
  • status: Status of the upload.
  • message: Any additional information or error messages.
  • Other metadata returned by the API.

Example output:

{
  "id": "12345",
  "status": "success",
  "message": "Asset uploaded successfully"
}

• If the API returns a non-JSON response, the raw body will be provided in the output.

Dependencies

• External Service: Requires access to the 1001fx API.
• API Key: You must configure the 1001fxApi credential in n8n with your API key.
• n8n Configuration: Ensure the node has access to the binary data you wish to upload (e.g., from a previous node).

Troubleshooting

Common issues:

• Missing Binary Data: If the "Asset file" property does not reference valid binary data, the upload will fail.
• Invalid Credentials: If the 1001fxApi credential is missing or incorrect, authentication errors will occur.
• File Size Limits: Large files may be rejected by the API; check 1001fx documentation for limits.

Error messages:

• "error": "Cannot read property 'fileName' of undefined": The referenced binary property does not exist. Ensure the input item contains the expected binary data.
• "error": "401 Unauthorized": Check your API credentials.
• "error": "Request failed with status code 4xx/5xx": Indicates an issue with the request or server. Review the error message for details.

Links and References

• 1001fx API Documentation
• n8n Documentation: Working with Binary Data
• n8n Credentials Setup