OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node operation retrieves the list of available assignees for a specific work package in OpenProject. It is useful when you want to dynamically fetch and display users who can be assigned to a particular work package, for example, to populate dropdowns or validate assignment options in workflows managing project tasks.

Practical examples:

  • Automatically fetching assignable users before updating a work package.
  • Validating if a user is eligible to be assigned to a given work package.
  • Displaying available assignees in a custom dashboard or report.

Properties

Name Meaning
Id The unique identifier (number) of the work package for which to retrieve available assignees.

Output

The output will contain a JSON array listing the available assignees for the specified work package. Each item typically includes user details such as user ID, name, and possibly other metadata related to the assignee.

If the node supports binary data output, it would generally relate to attachments or files associated with the work package, but this operation focuses on user data and does not output binary content.

Dependencies

  • Requires an API key credential to authenticate with the OpenProject API.
  • Needs the base URL of the OpenProject instance configured in the node credentials.
  • Depends on the OpenProject REST API endpoint that provides available assignees for a work package.

Troubleshooting

  • Common issues:

    • Invalid or missing work package ID: Ensure the "Id" property is set correctly and corresponds to an existing work package.
    • Authentication errors: Verify that the API key and base URL are correctly configured in the node credentials.
    • Network or connectivity problems: Check network access to the OpenProject server.
  • Error messages:

    • 401 Unauthorized: Indicates invalid or missing API authentication token. Resolve by updating credentials.
    • 404 Not Found: The specified work package ID does not exist. Confirm the ID value.
    • 500 Internal Server Error: Server-side issue; retry later or contact OpenProject support.

Links and References

Discussion