OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

The node interacts with the "File Links" resource of an API, specifically supporting the "Update Storage" operation. It allows users to update storage configurations by specifying a storage ID and optionally changing its name, application password (for Nextcloud storages), and related link metadata.

This node is useful in scenarios where you need to programmatically manage storage settings within a file linking or project management system, such as updating credentials or renaming storage locations without manual intervention. For example, automating updates to storage credentials when rotating passwords or renaming storage entries for clarity.

Properties

Name Meaning
Id The unique identifier of the storage to update. This is required to specify which storage entry will be modified.
Name Optional new name for the storage. If not provided, the storage name remains unchanged or falls back to a default value.
Application Password The application password used for Nextcloud storage. Setting a string enables automatic password management; setting null disables it. Ignored if the storage provider is not Nextcloud.
Links JSON object representing related links metadata for the storage, including origin href and method, and type information. Used internally in the request body.

Output

The node outputs JSON data representing the updated storage object as returned by the API after the update operation. The exact structure depends on the API response but typically includes updated fields such as storage id, name, credentials status, and associated links.

No binary data output is indicated.

Dependencies

  • Requires an API key or authentication token configured in n8n credentials to authorize requests to the target API.
  • The base URL for the API must be set in the node's credential configuration.
  • The node uses JSON-formatted HTTP requests and expects JSON responses.

Troubleshooting

  • Missing or invalid storage ID: The update operation requires a valid storage ID. Ensure the "Id" property is correctly set and corresponds to an existing storage.
  • Invalid application password format: When updating the application password, provide either a string to set or null to unset. Other types may cause errors.
  • API authentication errors: Verify that the API credentials are correctly configured and have sufficient permissions to update storage.
  • Malformed JSON in Links property: The "_links" property expects valid JSON. Invalid JSON syntax will cause request failures.
  • Provider mismatch: The application password is only applicable for Nextcloud storage providers. Setting it for other providers has no effect and might cause confusion.

Links and References

  • Refer to the API documentation of the file linking or project management system for detailed schema and behavior of the storage update endpoint.
  • Nextcloud application password management documentation for understanding password usage and restrictions.

Discussion