Runn icon

Runn

Interact with Runn.io API

Overview

This node integrates with a project management system to perform various operations on different resources such as Projects, Clients, and People. Specifically for the "Projects" resource with the "Get One" operation, it retrieves detailed information about a single project identified by its unique ID. This is useful in scenarios where you need to fetch up-to-date data about a specific project, for example, to display project details in a dashboard or to use the project data in subsequent workflow steps.

Properties

Name Meaning
ID The unique identifier of the project to retrieve. This is a required string input.
Options A collection of additional optional parameters that can be set to modify the request.

Note: For the "Get One" operation on Projects, only the "ID" property is required and used to specify which project to fetch.

Output

The output of this node is an array containing one or more items, each with a json field representing the retrieved project data. The structure of the json output corresponds to the project's properties as returned by the external API, typically including fields like project name, description, status, start/end dates, and other metadata.

If the node encounters an error and the workflow is configured to continue on failure, the output will contain an item with a json field holding an error message describing what went wrong.

The node does not explicitly handle binary data output.

Dependencies

  • Requires access to the external project management system's API.
  • Needs an API authentication token or key configured in n8n credentials (referred generically as "an API key credential").
  • The node depends on internal helper modules for executing operations on Projects, Clients, and People resources.

Troubleshooting

  • Common Issues:

    • Invalid or missing project ID: Ensure the "ID" property is correctly set to a valid project identifier.
    • Authentication errors: Verify that the API key or authentication token is correctly configured and has sufficient permissions.
    • Unsupported resource or operation: Confirm that the resource is set to "Projects" and the operation to "Get One".
  • Error Messages:

    • "Unsupported resource <resource>": Indicates the resource parameter is invalid or not implemented.
    • API errors returned from the external service will be passed through; check the error message for details.
  • To resolve errors, verify input parameters, credentials, and network connectivity.

Links and References

  • Refer to the external project management system’s official API documentation for details on project data structure and available endpoints.
  • n8n documentation on creating and configuring custom nodes: https://docs.n8n.io/integrations/creating-nodes/

Discussion