OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node interacts with the "File Links" resource of an external service to retrieve files stored in a specified storage location. Specifically, the "Get Storage Files" operation fetches files from a given storage identified by its ID and optionally filters them by a parent directory path.

Common scenarios for this node include:

  • Listing files within a particular storage system or repository.
  • Retrieving files under a specific folder or directory path.
  • Integrating file management workflows where files need to be fetched dynamically based on storage and folder criteria.

For example, you might use this node to get all files stored under /my/data in storage with ID 1337 to process or analyze them further in your workflow.

Properties

Name Meaning
Id The numeric identifier of the storage from which to retrieve files.
Parent (Optional) The path of the parent directory to filter files by. Defaults to /my/data.

Output

The node outputs JSON data representing the list of files retrieved from the specified storage and parent directory. Each item in the output typically contains metadata about a file such as its name, path, size, and other relevant attributes depending on the external API's response structure.

If the node supports binary data output (not explicitly shown here), it would represent the actual file contents or attachments; however, based on the provided code and properties, the output focuses on JSON metadata about storage files.

Dependencies

  • Requires an API key credential to authenticate requests against the external service's API.
  • Needs the base URL of the external service configured in the node credentials.
  • Depends on the external service's API endpoint that supports fetching storage files by storage ID and optional parent path query.

Troubleshooting

  • Invalid Storage ID: If the provided storage ID does not exist or is incorrect, the node may return an error or empty result. Verify the storage ID is valid.
  • Incorrect Parent Path: Providing a non-existent or malformed parent path may lead to no files being returned. Ensure the path exists in the storage.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Confirm that the API key and base URL are correctly set.
  • Network Issues: Connectivity problems to the external API endpoint can cause timeouts or errors. Check network access and endpoint availability.

Links and References

  • Refer to the external service's official API documentation for details on the "File Links" resource and the "Get Storage Files" operation.
  • n8n documentation on how to configure API credentials and use HTTP request nodes for custom integrations.

Discussion