Opencell icon

Opencell

Consume Opencell API

Overview

The File Explorer - Create Directory operation in this n8n node allows you to create a new directory (folder) on the remote Opencell server via its API. This is useful for automating file management tasks, such as organizing files into folders before uploading, archiving, or processing them further within your workflow.

Practical scenarios:

  • Automatically creating a dated folder for daily report uploads.
  • Organizing user-specific directories when onboarding new clients.
  • Preparing folder structures before batch file transfers.

Properties

Name Type Meaning
Authentication options Selects the authentication method for connecting to Opencell (Basic Authentication or OAuth2).
Body Content Type hidden Internal property; always set to "multipart-form-data" for file-related operations.
Directory Path string The path where the new directory should be created on the Opencell server. Required.

Output

  • The output will be a JSON object containing the response from the Opencell API after attempting to create the directory.
  • The structure of the json field depends on the Opencell API's response for the directory creation endpoint. Typically, it may include status information, success/failure messages, and possibly details about the created directory.

Example output:

{
  "json": {
    // Response fields from Opencell, e.g.,
    "status": "success",
    "message": "Directory created successfully",
    "dirPath": "/your/specified/path"
  },
  "pairedItem": {
    "item": 0
  }
}

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 the Opencell API.
  • 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, ensure your credentials are correct and have sufficient permissions.
  • Directory already exists: Attempting to create a directory that already exists may result in an error from the API.
  • Invalid path: Supplying an invalid or forbidden path can cause the operation to fail.
  • Network/API errors: Connectivity issues or incorrect API base URLs can prevent successful requests.

Error messages:

  • "Username/password error. Error code : ...": Check your authentication credentials.
  • "Host error. Error code : ...": Verify the Opencell server address and network connectivity.
  • "Invalid credentials (unknown error)": Double-check your credential setup in n8n.

Links and References

Discussion