OpenProjectInstall

Overview

This node interacts with the OpenProject API to list all categories associated with a specific project. It is useful when you want to retrieve and display or process the categories defined within a given project in OpenProject, such as for reporting, filtering tasks by category, or synchronizing project metadata.

A practical example would be automating the retrieval of all categories for a project to populate dropdowns in other workflows or to analyze how many categories exist per project.

Properties

Output

The node outputs JSON data containing the list of categories for the specified project. Each category typically includes details such as its unique identifier, name, and possibly additional metadata depending on the OpenProject API response.

No binary data output is involved.

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.
• The node uses standard HTTP headers for JSON communication (Accept: application/json and Content-Type: application/json).

Troubleshooting

• Common issues:

  • Invalid or missing project ID: Ensure the project ID provided exists and is accessible with the authenticated user.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Network or connectivity problems: Check the base URL configuration and network access to the OpenProject server.

• Error messages:

  • Unauthorized or 401 errors indicate invalid or missing authentication credentials.
  • 404 errors may mean the project ID does not exist.
  • Timeout or connection errors suggest network issues or incorrect base URL.

Resolving these usually involves verifying credentials, project IDs, and network settings.

Links and References

• OpenProject API Documentation
• OpenProject Categories API Reference (for detailed category fields and usage)