OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node interacts with the OpenProject API to list project storages filtered by specific criteria. It is useful when you want to retrieve storage information related to projects in OpenProject, such as identifying which storages are linked to particular projects or filtering storages by URL or ID.

Practical examples include:

  • Fetching all storages associated with a given project to audit or manage file links.
  • Filtering storages by their unique identifiers or URLs for integration or reporting purposes.

Properties

Name Meaning
Filters A JSON string specifying filter conditions to narrow down the list of project storages. Supported filters include:
- project_id
- storage_id
- storage_url
Example format matches OpenProject query filters.

Output

The node outputs JSON data representing the list of project storages that match the specified filters. Each item in the output typically contains details about a project storage entity, such as its ID, associated project, storage URL, and other metadata as provided by the OpenProject API.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the OpenProject API.
  • The node expects the base URL of the OpenProject instance to be configured in the credentials.
  • Uses the OpenProject REST API endpoint for queries related to project storages.

Troubleshooting

  • Invalid Filter Format: If the Filters property JSON is malformed or uses unsupported filter keys, the API may return errors or empty results. Ensure the JSON is valid and only includes supported filters (project_id, storage_id, storage_url).
  • Authentication Errors: Missing or incorrect API credentials will cause authentication failures. Verify that the API key and base URL are correctly set in the node credentials.
  • Empty Results: If no storages are returned, check that the filter values correspond to existing projects or storages in your OpenProject instance.
  • API Endpoint Changes: If the OpenProject API changes, the node might fail. Keep the node and API version compatible.

Links and References

Discussion