Actions199
- Collections Actions
- Forms Actions
- Actions Capabilities Actions
- Activities Actions
- Attachments Actions
- Budgets Actions
- Categories Actions
- Custom Actions Actions
- Custom Options Actions
- Documents Actions
- File Links Actions
- View File Link
- Delete File Link
- Open File Link
- Download File Link
- List Project Storages
- Get Project Storage
- Open Project Storage
- Create Storage
- Get Storage
- Update Storage
- Delete Storage
- Get Storage Files
- Prepare Storage File Upload
- Create Storage Folder
- Create Storage Oauth Credentials
- Open Storage
- Create Work Package File Link
- List Work Package File Links
- Grids Actions
- Groups Actions
- Help Texts Actions
- Memberships Actions
- Query Filter Instance Schema Actions
- News Actions
- Notifications Actions
- O Auth 2 Actions
- Posts Actions
- Principals Actions
- Priorities Actions
- Query Columns Actions
- Query Filters Actions
- Query Operators Actions
- Query Sort Bys Actions
- Relations Actions
- Previewing Actions
- Revisions Actions
- Roles Actions
- Time Entries Actions
- Time Entry Activities Actions
- Types Actions
- User Preferences Actions
- Wiki Pages Actions
- Work Schedule Actions
- Meetings Actions
- Values Property Actions
- Projects Actions
- Queries Actions
- Users Actions
- Statuses Actions
- Versions Actions
- Work Packages Actions
- Get Project Work Package Collection
- Create Project Work Package
- List Work Package File Links
- Form Create Work Package In Project
- Project Available Assignees
- List Work Packages
- Create Work Package
- Form Create Work Package
- List Work Package Schemas
- View Work Package Schema
- Delete Work Package
- View Work Package
- Update Work Package
- List Work Package Activities
- Comment Work Package
- Work Package Available Assignees
- Available Projects For Work Package
- List Available Relation Candidates
- Available Watchers
- Create Work Package File Link
- Form Edit Work Package
- Revisions
- Reminders
- List Watchers
- Add Watcher
- Remove Watcher
- Views Actions
Overview
The node operation "Prepare Storage File Upload" under the "File Links" resource is designed to initiate the process of uploading a file to a storage system within a project context. It prepares the necessary parameters and sends them to the backend API, which likely responds with upload instructions or a pre-signed URL for the actual file transfer.
This node is beneficial in scenarios where users need to programmatically upload files into a structured project directory on a remote storage service. For example, automating document uploads to a project management platform or integrating file storage workflows into larger automation pipelines.
Properties
| Name | Meaning |
|---|---|
| Id | The unique identifier of the storage location where the file will be uploaded. |
| Project Id | The identifier of the project from which the user initiates the file upload. |
| File Name | The name of the file to be uploaded. |
| Parent | The target directory path within the storage where the file should be placed. Use / for root. |
Output
The node outputs JSON data representing the response from the storage preparation API. This typically includes information needed to proceed with the file upload, such as upload URLs, tokens, or metadata confirming the upload destination.
If the node supports binary data output (not explicitly shown in the provided code), it would relate to the file content or upload streams, but based on the static analysis, the output focuses on JSON metadata about the prepared upload.
Dependencies
- Requires an API key credential for authenticating requests to the OpenProject API.
- Depends on the OpenProject API endpoint configured via credentials, including the base URL.
- Uses the
@devlikeapro/n8n-openapi-nodepackage and an OpenAPI specification (openapi.json) to build request properties dynamically.
Troubleshooting
Common Issues:
- Incorrect or missing project ID or storage ID may cause the API to reject the request.
- Providing an invalid parent directory path could result in errors or unexpected upload locations.
- Network or authentication failures if the API key or base URL is misconfigured.
Error Messages:
- Authentication errors indicating invalid or missing API credentials require checking the configured API key.
- Validation errors related to required fields (Id, Project Id, File Name, Parent) suggest missing or malformed input parameters.
- API response errors might indicate permission issues or that the specified project/storage does not exist.