Opencell

Overview

The File Explorer - Upload File operation in this custom n8n node allows users to upload a file to the Opencell platform via its API. This is useful for automating the transfer of files (such as documents, data exports, or configuration files) into the Opencell system as part of larger business workflows. Typical scenarios include:

• Automating the upload of customer documents.
• Integrating external systems that generate files needing to be stored in Opencell.
• Scheduled or triggered uploads from other n8n processes.

Example:
A workflow that receives a file from an email attachment and uploads it directly to Opencell using this node.

---

Properties

Name	Type	Meaning
Authentication	options	Selects the authentication method: Basic Authentication or OAuth2.
Body Content Type	hidden	Always set to "multipart-form-data" for file uploads; not user-configurable.
File Content	string	The actual content of the file to upload (as a string or base64-encoded). Required.
File Path	string	The destination path (including filename) where the file will be uploaded. Required.

---

Output

• The output is a JSON object containing the response from the Opencell API after uploading the file.
• The structure of the output depends on the Opencell API's response for the upload endpoint, but typically includes status information and possibly metadata about the uploaded file.

Example output:

{
  "json": {
    // ...response fields from Opencell, e.g.,
    "status": "SUCCESS",
    "message": "File uploaded successfully",
    "filePath": "/destination/path/filename.ext"
  },
  "pairedItem": {
    "item": 0
  }
}

• No binary output is produced by this operation.

---

Dependencies

• External Service: Requires access to an Opencell instance with the REST API enabled.
• Authentication: You must configure either Basic Authentication or OAuth2 credentials in n8n for Opencell.
• n8n Configuration: Credentials must be set up in the n8n credential store under the names opencellApi (for Basic Auth) or opencellOAuth2Api (for OAuth2).

---

Troubleshooting

Common Issues:

• Invalid Credentials: If authentication fails, you may see errors like Username/password error. Error code : 401. Ensure your credentials are correct and have sufficient permissions.
• Missing Required Fields: If File Content or File Path is empty, the node will throw an error indicating required parameters are missing.
• API Endpoint Errors: If the Opencell API is unreachable or returns an error (e.g., due to invalid file paths or server issues), the error message from the API will be included in the node's output.

How to resolve:

• Double-check the authentication method and credentials.
• Ensure both File Content and File Path are provided and valid.
• Verify the Opencell API endpoint is accessible from your n8n instance.
• Check file size and format restrictions imposed by Opencell.

---

Links and References

• Opencell Documentation
• n8n Documentation: Custom Nodes
• n8n Credentials Setup

---