OpenProject

Interact with OpenProject API
Join our community

Actions15

Overview

This node operation creates a new work package in OpenProject. It allows users to specify details such as the subject, project association, type, description, status, priority, assignee, start and due dates, and estimated time. This is useful for project management workflows where tasks, milestones, or other work items need to be programmatically created and tracked within OpenProject.

Use Case Examples

  1. Creating a new task work package for a specific project with a defined subject, description, and assigned user.
  2. Creating a milestone work package with a set start and due date to track project phases.

Properties

Name Meaning
Subject The subject or title of the work package, describing the task or item.
Project ID The identifier of the project to which the work package belongs, selected from available projects.
Type The type of work package, such as Task, Milestone, Phase, Feature, Epic, User Story, or Bug.
Description A detailed description of the work package, providing additional context or information.
Status The current status of the work package, indicating its progress or state.
Priority The priority level of the work package, indicating its urgency or importance.
Assignee ID The user assigned to the work package, selected from available users.
Start Date The start date of the work package, indicating when work is planned to begin.
Due Date The due date of the work package, indicating the deadline for completion.
Estimated Time (Hours) The estimated time required to complete the work package, specified in hours.

Output

JSON

  • id - The unique identifier of the created work package.
  • subject - The subject or title of the created work package.
  • _links
    • project
      * href - Reference link to the associated project.
    • type
      * href - Reference link to the type of the work package.
    • status
      * href - Reference link to the status of the work package.
    • priority
      * href - Reference link to the priority of the work package.
    • assignee
      * href - Reference link to the assigned user, if any.
  • description
    • raw - The raw description text of the work package.
  • startDate - The start date of the work package.
  • dueDate - The due date of the work package.
  • estimatedTime - The estimated time in ISO 8601 duration format (e.g., PT5H for 5 hours).

Dependencies

  • An API key credential for OpenProject API authentication

Troubleshooting

  • Ensure the API key credential is correctly configured and has sufficient permissions to create work packages.
  • Verify that the project ID, type, status, priority, and assignee ID (if provided) exist and are valid in the OpenProject instance.
  • Check date formats for start and due dates to ensure they are valid ISO 8601 date strings.
  • If the API returns errors, review the error message for missing required fields or invalid values and adjust the input accordingly.

Links

Discussion