Actions21
Overview
This node integrates with the Runn platform to manage various resources such as clients, projects, and people. Specifically for the Projects resource with the Unarchive operation, it allows users to restore archived projects back to an active state in their Runn account. This is useful when a project was previously archived (perhaps because it was completed or put on hold) but now needs to be reactivated for further work or reporting.
Common scenarios include:
- Reopening a previously completed project to add new tasks or extend deadlines.
- Correcting accidental archiving of a project.
- Temporarily archived projects that need to be resumed.
Example: A project manager wants to unarchive a project with ID "12345" to continue tracking its progress and assign new team members.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the project to unarchive. |
| Dry Run | When enabled (true), simulates the unarchive operation without making any actual changes in Runn. |
| Options | Additional optional parameters for the operation (currently no specific options defined). |
Output
The node outputs an array of JSON objects representing the result of the unarchive operation. Each object corresponds to one input item processed and contains the updated project data as returned by the Runn API.
If the operation is run in dry-run mode, the output will simulate the response without changing the project status in Runn.
No binary data output is produced by this node.
Dependencies
- Requires access to the Runn API via an authenticated connection using an API key or token configured in n8n credentials.
- The node depends on internal helper modules for handling API requests to Runn's projects endpoint.
- No additional external services are required beyond Runn itself.
Troubleshooting
Common issues:
- Invalid or missing project ID: The node requires a valid project ID; otherwise, the API call will fail.
- Insufficient permissions or invalid API credentials can cause authentication errors.
- Attempting to unarchive a project that is not archived may result in an error or no change.
Error messages:
"Unsupported resource": Occurs if the resource parameter is set incorrectly.- API errors from Runn will be passed through; check the message for details like "Project not found" or "Unauthorized".
Resolutions:
- Verify the project ID exists and is correct.
- Ensure the API credentials have sufficient permissions.
- Use the Dry Run option to test the operation without affecting live data.
Links and References
- Runn API Documentation (for detailed API endpoints and payloads)
- n8n Documentation (for general usage of custom nodes and credentials setup)
