# OpenProject

> Plan and track work in OpenProject: create, update and find work packages, comment, log and find time, and start a workflow when a work package is created or changes.

App · 9 actions. Web page: https://docs.lodol.com/docs/integrations/openproject

## Actions

### Add comment

Comment on a work package, as its Activity tab does. Markdown works.

**Inputs**

- Work package (`work_package`, text, required): The work package's number, such as 482, or its link.
- Comment (`comment`, text, required): What to write.

**Outputs**

- `activity_id` (number): The comment's entry in the work package's activity
- `author` (text): Who it's from: the connected user
- `comment` (text): The comment added
- `created_at` (text): When the entry was made (ISO 8601)
- `link` (text): A link to the work package's activity in OpenProject
- `work_package_id` (number): The work package's number

**Example output**

```json
{
  "activity_id": 1908,
  "author": "Jane Doe",
  "comment": "The customer confirmed the fix works.",
  "created_at": "2026-11-05T15:20:00Z",
  "link": "https://yourcompany.openproject.com/work_packages/482/activity",
  "work_package_id": 482
}
```

### Create work package

Create a work package in a project, such as a task from a form, a bug from an alert or a feature request from an email.

**Inputs**

- Project (`project`, text, required): The project to add it to.
- Subject (`subject`, text, required): Its one-line title.
- Type (`type`, text): What kind of work package, such as Task, Bug or Feature. Leave blank for the project's default type.
- Description (`description`, text): The details, in Markdown.
- Assignee (`assignee`, text): Who will do it: a project member's name, username or ID, or me.
- Accountable (`accountable`, text): Who is accountable for it: a project member's name, username or ID, or me.
- Priority (`priority`, text): How urgent it is. Leave blank for OpenProject's default.
- Start date (`start_date`, date): When work starts.
- Finish date (`due_date`, date): When it's due.
- Work (`estimated_hours`, number): How many hours the work should take, such as 4 or 1.5. From 0 to 1000.
- Parent (`parent`, text): Make it a child of this work package: its number or link.
- Custom fields (`custom_fields`, object): Values for the project's custom fields, by the field's name as OpenProject shows it, such as Customer: Acme Ltd. A list field takes its choice's name.

**Outputs**

- `accountable` (text): Who is accountable for it; empty if nobody
- `accountable_id` (number): The accountable person's ID; 0 if nobody
- `assignee` (text): Who it's assigned to; empty if nobody
- `assignee_id` (number): The assignee's ID; 0 if nobody
- `author` (text): Who created it
- `author_id` (number): The ID of who created it
- `created_at` (text): When it was created (ISO 8601)
- `custom_fields` (object): Its custom fields' values, by field name
- `description` (text): Its description, in Markdown
- `due_date` (text): Its finish date (YYYY-MM-DD); empty if none
- `estimated_hours` (number): The work estimated for it, in hours; 0 if none
- `id` (number): The work package's number
- `is_closed` (true/false): Whether its status counts as closed
- `link` (text): A link to it in OpenProject
- `lock_version` (number): Its version, which goes up each time it changes
- `parent_id` (number): Its parent work package's number; 0 if none
- `percentage_done` (number): How far done it is (% Complete), from 0 to 100
- `priority` (text): Its priority, such as Normal or High
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `remaining_hours` (number): The work remaining, in hours; 0 if none
- `spent_hours` (number): The hours logged on it
- `start_date` (text): Its start date (YYYY-MM-DD); empty if none
- `status` (text): Its status, such as New or In progress
- `subject` (text): Its one-line title
- `type` (text): Its type, such as Task, Bug or Feature
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "accountable": "",
  "accountable_id": 0,
  "assignee": "Sam Patel",
  "assignee_id": 6,
  "author": "Jane Doe",
  "author_id": 5,
  "created_at": "2026-11-05T09:12:44Z",
  "custom_fields": {
    "Customer": "Acme Ltd"
  },
  "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
  "due_date": "2026-11-12",
  "estimated_hours": 4.0,
  "id": 482,
  "is_closed": false,
  "link": "https://yourcompany.openproject.com/work_packages/482",
  "lock_version": 3,
  "parent_id": 0,
  "percentage_done": 30,
  "priority": "High",
  "project": "Website",
  "project_id": 3,
  "remaining_hours": 2.8,
  "spent_hours": 1.5,
  "start_date": "2026-11-05",
  "status": "In progress",
  "subject": "Contact form does not send",
  "type": "Bug",
  "updated_at": "2026-11-05T14:03:10Z"
}
```

### Delete work package

Delete a work package for good, with its children, comments and the time logged on it. It can't be restored.

**Inputs**

- Work package (`work_package`, text, required): The work package's number, such as 482, or its link.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (number): The deleted work package's number

**Example output**

```json
{
  "deleted": true,
  "id": 482
}
```

### Find time entries

Find the time logged in a project or on a work package, by someone or between two dates, newest first, with the hours added up.

**Inputs**

- Project (`project`, text): Only this project. Leave blank for every project.
- Work package (`work_package`, text): Only time logged on this work package: its number or link.
- Spent by (`user`, text): Only time this person logged, or me.
- From (`from_date`, date): Only time spent on or after this day.
- To (`to_date`, date): Only time spent on or before this day.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many are listed
- `hours` (number): The hours of those listed, added up
- `time_entries` (list): The time entries, newest first
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "hours": 1.5,
  "time_entries": [
    {
      "activity": "Development",
      "comment": "Fixed the mail settings",
      "created_at": "2026-11-05T16:00:00Z",
      "hours": 1.5,
      "id": 2201,
      "project": "Website",
      "project_id": 3,
      "spent_on": "2026-11-05",
      "user": "Sam Patel",
      "user_id": 6,
      "work_package": "Contact form does not send",
      "work_package_id": 482
    }
  ],
  "total": 1
}
```

### Find work packages

Find work packages by project, status, type, assignee, priority, words or when they changed. Most recently updated first, unless you pick another order.

**Inputs**

- Project (`project`, text): Only this project. Leave blank for every project.
- Status (`status`, text): Any open status, any closed status, any status, or one status. Leave blank for open work packages.
- Type (`type`, text): Only this type.
- Assignee (`assignee`, text): Only work packages assigned to this person, me, or none for those assigned to nobody.
- Priority (`priority`, text): Only this priority.
- Words (`text`, text): Only work packages with these words in their subject, description or comments.
- Updated since (`updated_since`, date and time): Only work packages changed at or after this time.
- Created since (`created_since`, date and time): Only work packages created at or after this time.
- Order (`sort`, text): Which come first. One of: `updated` (Most recently updated), `created` (Most recently created), `priority` (Highest priority), `due` (Soonest due). Default: `updated`.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many are listed
- `total` (number): How many match in all
- `work_packages` (list): The work packages found

**Example output**

```json
{
  "count": 1,
  "total": 1,
  "work_packages": [
    {
      "accountable": "",
      "accountable_id": 0,
      "assignee": "Sam Patel",
      "assignee_id": 6,
      "author": "Jane Doe",
      "author_id": 5,
      "created_at": "2026-11-05T09:12:44Z",
      "custom_fields": {
        "Customer": "Acme Ltd"
      },
      "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
      "due_date": "2026-11-12",
      "estimated_hours": 4.0,
      "id": 482,
      "is_closed": false,
      "link": "https://yourcompany.openproject.com/work_packages/482",
      "lock_version": 3,
      "parent_id": 0,
      "percentage_done": 30,
      "priority": "High",
      "project": "Website",
      "project_id": 3,
      "remaining_hours": 2.8,
      "spent_hours": 1.5,
      "start_date": "2026-11-05",
      "status": "In progress",
      "subject": "Contact form does not send",
      "type": "Bug",
      "updated_at": "2026-11-05T14:03:10Z"
    }
  ]
}
```

### Get work package

Get a work package's details, and its comments and changes if you ask for them.

**Inputs**

- Work package (`work_package`, text, required): The work package's number, such as 482, or its link.
- Include activity (`include_activity`, true/false): Also get its comments and changes, oldest first (the newest 50).

**Outputs**

- `accountable` (text): Who is accountable for it; empty if nobody
- `accountable_id` (number): The accountable person's ID; 0 if nobody
- `activity` (list): Its comments and changes, oldest first (the newest 50); empty unless asked for
- `assignee` (text): Who it's assigned to; empty if nobody
- `assignee_id` (number): The assignee's ID; 0 if nobody
- `author` (text): Who created it
- `author_id` (number): The ID of who created it
- `created_at` (text): When it was created (ISO 8601)
- `custom_fields` (object): Its custom fields' values, by field name
- `description` (text): Its description, in Markdown
- `due_date` (text): Its finish date (YYYY-MM-DD); empty if none
- `estimated_hours` (number): The work estimated for it, in hours; 0 if none
- `id` (number): The work package's number
- `is_closed` (true/false): Whether its status counts as closed
- `link` (text): A link to it in OpenProject
- `lock_version` (number): Its version, which goes up each time it changes
- `parent_id` (number): Its parent work package's number; 0 if none
- `percentage_done` (number): How far done it is (% Complete), from 0 to 100
- `priority` (text): Its priority, such as Normal or High
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `remaining_hours` (number): The work remaining, in hours; 0 if none
- `spent_hours` (number): The hours logged on it
- `start_date` (text): Its start date (YYYY-MM-DD); empty if none
- `status` (text): Its status, such as New or In progress
- `subject` (text): Its one-line title
- `type` (text): Its type, such as Task, Bug or Feature
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "accountable": "",
  "accountable_id": 0,
  "activity": [
    {
      "changes": [
        "Status changed from New to In progress",
        "% Complete changed from 0% to 30%"
      ],
      "comment": "Reproduced on Safari; looking at the mail settings.",
      "created_at": "2026-11-05T14:03:10Z",
      "id": 1907,
      "user": "Sam Patel",
      "user_id": 6
    }
  ],
  "assignee": "Sam Patel",
  "assignee_id": 6,
  "author": "Jane Doe",
  "author_id": 5,
  "created_at": "2026-11-05T09:12:44Z",
  "custom_fields": {
    "Customer": "Acme Ltd"
  },
  "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
  "due_date": "2026-11-12",
  "estimated_hours": 4.0,
  "id": 482,
  "is_closed": false,
  "link": "https://yourcompany.openproject.com/work_packages/482",
  "lock_version": 3,
  "parent_id": 0,
  "percentage_done": 30,
  "priority": "High",
  "project": "Website",
  "project_id": 3,
  "remaining_hours": 2.8,
  "spent_hours": 1.5,
  "start_date": "2026-11-05",
  "status": "In progress",
  "subject": "Contact form does not send",
  "type": "Bug",
  "updated_at": "2026-11-05T14:03:10Z"
}
```

### List projects

List every project the connected user can see, with its identifier.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `projects` (list): The projects

**Example output**

```json
{
  "count": 1,
  "projects": [
    {
      "active": true,
      "created_at": "2026-01-14T10:00:00Z",
      "description": "The company website",
      "id": 3,
      "identifier": "website",
      "link": "https://yourcompany.openproject.com/projects/website",
      "name": "Website",
      "parent": "",
      "parent_id": 0,
      "public": false
    }
  ]
}
```

### Log time

Log hours spent on a work package.

**Inputs**

- Work package (`work_package`, text, required): The work package's number, such as 482, or its link.
- Hours (`hours`, number, required): How long, in hours, such as 1.5. From 0.01 to 1000.
- Activity (`activity`, text): What kind of work, such as Development. Leave blank for none.
- Date (`spent_on`, date): The day it was spent. Leave blank for today.
- Comment (`comment`, text): What was done, in a line.
- Spent by (`user`, text): Log it for someone else. Needs permission to log time for other users. Leave blank for the connected user.

**Outputs**

- `activity` (text): What kind of work, such as Development; empty if not given
- `comment` (text): What was done
- `created_at` (text): When it was logged (ISO 8601)
- `hours` (number): How many hours
- `id` (number): The time entry's ID
- `project` (text): The project the time was spent in
- `project_id` (number): The project's ID
- `spent_on` (text): The day it was spent (YYYY-MM-DD)
- `user` (text): Who spent it
- `user_id` (number): Their ID
- `work_package` (text): The work package's title
- `work_package_id` (number): The work package's number

**Example output**

```json
{
  "activity": "Development",
  "comment": "Fixed the mail settings",
  "created_at": "2026-11-05T16:00:00Z",
  "hours": 1.5,
  "id": 2201,
  "project": "Website",
  "project_id": 3,
  "spent_on": "2026-11-05",
  "user": "Sam Patel",
  "user_id": 6,
  "work_package": "Contact form does not send",
  "work_package_id": 482
}
```

### Update work package

Change a work package's status, assignee, priority, % complete, dates or other fields, with a comment saying why. A change someone made at the same moment is kept.

**Inputs**

- Work package (`work_package`, text, required): The work package's number, such as 482, or its link.
- Status (`status`, text): Move it to this status, such as In progress or Closed. Leave blank to keep it.
- Assignee (`assignee`, text): Who will do it: a name, username or ID, me, or none to leave it with nobody. Leave blank to keep it.
- Priority (`priority`, text): A new priority. Leave blank to keep it.
- % Complete (`percentage_done`, number): How far done it is, from 0 to 100. Leave blank to keep it. From 0 to 100.
- Comment (`comment`, text): A comment to add with the change, saying why. Markdown works.
- Subject (`subject`, text): A new one-line title. Leave blank to keep it.
- Description (`description`, text): A new description, in Markdown, replacing the old one. Leave blank to keep it.
- Type (`type`, text): Change it to this type. Leave blank to keep it.
- Accountable (`accountable`, text): Who is accountable for it: a name, username or ID, me, or none. Leave blank to keep it.
- Start date (`start_date`, date): A new start date. Leave blank to keep it.
- Finish date (`due_date`, date): A new finish date. Leave blank to keep it.
- Work (`estimated_hours`, number): How many hours the work should take, such as 4 or 1.5. From 0 to 1000.
- Custom fields (`custom_fields`, object): Values for the project's custom fields, by the field's name as OpenProject shows it, such as Customer: Acme Ltd. A list field takes its choice's name.

**Outputs**

- `accountable` (text): Who is accountable for it; empty if nobody
- `accountable_id` (number): The accountable person's ID; 0 if nobody
- `assignee` (text): Who it's assigned to; empty if nobody
- `assignee_id` (number): The assignee's ID; 0 if nobody
- `author` (text): Who created it
- `author_id` (number): The ID of who created it
- `created_at` (text): When it was created (ISO 8601)
- `custom_fields` (object): Its custom fields' values, by field name
- `description` (text): Its description, in Markdown
- `due_date` (text): Its finish date (YYYY-MM-DD); empty if none
- `estimated_hours` (number): The work estimated for it, in hours; 0 if none
- `id` (number): The work package's number
- `is_closed` (true/false): Whether its status counts as closed
- `link` (text): A link to it in OpenProject
- `lock_version` (number): Its version, which goes up each time it changes
- `parent_id` (number): Its parent work package's number; 0 if none
- `percentage_done` (number): How far done it is (% Complete), from 0 to 100
- `priority` (text): Its priority, such as Normal or High
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `remaining_hours` (number): The work remaining, in hours; 0 if none
- `spent_hours` (number): The hours logged on it
- `start_date` (text): Its start date (YYYY-MM-DD); empty if none
- `status` (text): Its status, such as New or In progress
- `subject` (text): Its one-line title
- `type` (text): Its type, such as Task, Bug or Feature
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "accountable": "",
  "accountable_id": 0,
  "assignee": "Sam Patel",
  "assignee_id": 6,
  "author": "Jane Doe",
  "author_id": 5,
  "created_at": "2026-11-05T09:12:44Z",
  "custom_fields": {
    "Customer": "Acme Ltd"
  },
  "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
  "due_date": "2026-11-12",
  "estimated_hours": 4.0,
  "id": 482,
  "is_closed": false,
  "link": "https://yourcompany.openproject.com/work_packages/482",
  "lock_version": 3,
  "parent_id": 0,
  "percentage_done": 30,
  "priority": "High",
  "project": "Website",
  "project_id": 3,
  "remaining_hours": 2.8,
  "spent_hours": 1.5,
  "start_date": "2026-11-05",
  "status": "In progress",
  "subject": "Contact form does not send",
  "type": "Bug",
  "updated_at": "2026-11-05T14:03:10Z"
}
```
