# Redmine

> Track work in Redmine: open, update and find issues, add notes, log and find time, and start a workflow when an issue is opened or changes.

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

## Actions

### Add note

Add a note (a comment) to an issue, as Redmine's Notes box does.

**Inputs**

- Issue (`issue`, text, required): The issue's number, such as 482, or its link.
- Note (`note`, text, required): What to write.
- Private (`private`, true/false): Only roles allowed to see private notes see it.

**Outputs**

- `author` (text): Who it's from: the connected user
- `created_on` (text): When it was added (ISO 8601)
- `issue_id` (number): The issue's number
- `link` (text): A link to the note in Redmine
- `note` (text): The note added
- `note_id` (number): The note's ID in the issue's history
- `private` (true/false): Whether the note is private

**Example output**

```json
{
  "author": "Jane Doe",
  "created_on": "2026-11-05T15:20:00Z",
  "issue_id": 482,
  "link": "https://redmine.example.com/issues/482#change-1908",
  "note": "The customer confirmed the fix works.",
  "note_id": 1908,
  "private": false
}
```

### Create issue

Open an issue in a project, such as a bug from a form or a task from an email.

**Inputs**

- Project (`project`, text, required): The project to add it to.
- Subject (`subject`, text, required): Its one-line summary.
- Description (`description`, text): The details.
- Tracker (`tracker`, text): What kind of issue, such as Bug or Feature. Leave blank for the project's first tracker.
- Priority (`priority`, text): How urgent it is. Leave blank for Redmine's default.
- Assignee (`assignee`, text): Who to assign it to: a project member's name, login or ID, or me.
- Start date (`start_date`, date): When work starts.
- Due date (`due_date`, date): When it's due.
- Estimated hours (`estimated_hours`, number): How many hours the work should take, such as 4 or 1.5. From 0 to 1000.
- Parent issue (`parent_issue`, text): Make it a subtask of this issue: its number or link.
- Private (`is_private`, true/false): Only its author, assignee and roles allowed to see private issues see it.
- Custom fields (`custom_fields`, object): Values for the project's custom fields, by the field's name as Redmine shows it, such as Customer: Acme Ltd.

**Outputs**

- `assignee` (text): Who it's assigned to; empty if nobody
- `assignee_id` (number): The assignee's ID; 0 if nobody
- `author` (text): Who opened it
- `author_id` (number): The ID of who opened it
- `category` (text): Its category; empty if none
- `closed_on` (text): When it was closed (ISO 8601); empty if open
- `created_on` (text): When it was opened (ISO 8601)
- `custom_fields` (object): Its custom fields' values, by field name
- `description` (text): Its description
- `done_ratio` (number): How far done it is, from 0 to 100
- `due_date` (text): Its due date (YYYY-MM-DD); empty if none
- `estimated_hours` (number): The hours estimated for it; 0 if none
- `id` (number): The issue's number
- `is_closed` (true/false): Whether its status counts as closed
- `is_private` (true/false): Whether only its author, assignee and some roles see it
- `link` (text): A link to it in Redmine
- `parent_id` (number): Its parent issue's number; 0 if none
- `priority` (text): Its priority, such as Normal or High
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `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 Resolved
- `subject` (text): Its one-line summary
- `target_version` (text): The version it's planned for; empty if none
- `tracker` (text): Its tracker, such as Bug or Feature
- `updated_on` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "assignee": "Sam Patel",
  "assignee_id": 7,
  "author": "Jane Doe",
  "author_id": 5,
  "category": "",
  "closed_on": "",
  "created_on": "2026-11-05T09:12:44Z",
  "custom_fields": {
    "Customer": "Acme Ltd"
  },
  "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
  "done_ratio": 30,
  "due_date": "2026-11-12",
  "estimated_hours": 4.0,
  "id": 482,
  "is_closed": false,
  "is_private": false,
  "link": "https://redmine.example.com/issues/482",
  "parent_id": 0,
  "priority": "High",
  "project": "Website",
  "project_id": 3,
  "spent_hours": 1.5,
  "start_date": "2026-11-05",
  "status": "In Progress",
  "subject": "Contact form does not send",
  "target_version": "",
  "tracker": "Bug",
  "updated_on": "2026-11-05T14:03:10Z"
}
```

### Delete issue

Delete an issue for good, with its notes, files and the time logged on it. It can't be restored.

**Inputs**

- Issue (`issue`, text, required): The issue's number, such as 482, or its link.

**Outputs**

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

**Example output**

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

### Find issues

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

**Inputs**

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

**Outputs**

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

**Example output**

```json
{
  "count": 1,
  "issues": [
    {
      "assignee": "Sam Patel",
      "assignee_id": 7,
      "author": "Jane Doe",
      "author_id": 5,
      "category": "",
      "closed_on": "",
      "created_on": "2026-11-05T09:12:44Z",
      "custom_fields": {
        "Customer": "Acme Ltd"
      },
      "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
      "done_ratio": 30,
      "due_date": "2026-11-12",
      "estimated_hours": 4.0,
      "id": 482,
      "is_closed": false,
      "is_private": false,
      "link": "https://redmine.example.com/issues/482",
      "parent_id": 0,
      "priority": "High",
      "project": "Website",
      "project_id": 3,
      "spent_hours": 1.5,
      "start_date": "2026-11-05",
      "status": "In Progress",
      "subject": "Contact form does not send",
      "target_version": "",
      "tracker": "Bug",
      "updated_on": "2026-11-05T14:03:10Z"
    }
  ],
  "total": 1
}
```

### Find time entries

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

**Inputs**

- Project (`project`, text): Only this project (and its subprojects). Leave blank for every project.
- Issue (`issue`, text): Only time logged on this issue: 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 100.

**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",
      "comments": "Fixed the mail settings",
      "created_on": "2026-11-05T16:00:00Z",
      "hours": 1.5,
      "id": 2201,
      "issue_id": 482,
      "project": "Website",
      "project_id": 3,
      "spent_on": "2026-11-05",
      "user": "Sam Patel",
      "user_id": 7
    }
  ],
  "total": 1
}
```

### Get issue

Get an issue's details, and its notes and changes if you ask for them.

**Inputs**

- Issue (`issue`, text, required): The issue's number, such as 482, or its link.
- Include history (`include_history`, true/false): Also get its notes and every change made to it, oldest first.

**Outputs**

- `assignee` (text): Who it's assigned to; empty if nobody
- `assignee_id` (number): The assignee's ID; 0 if nobody
- `author` (text): Who opened it
- `author_id` (number): The ID of who opened it
- `category` (text): Its category; empty if none
- `closed_on` (text): When it was closed (ISO 8601); empty if open
- `created_on` (text): When it was opened (ISO 8601)
- `custom_fields` (object): Its custom fields' values, by field name
- `description` (text): Its description
- `done_ratio` (number): How far done it is, from 0 to 100
- `due_date` (text): Its due date (YYYY-MM-DD); empty if none
- `estimated_hours` (number): The hours estimated for it; 0 if none
- `history` (list): Its notes and changes, oldest first; empty unless asked for
- `id` (number): The issue's number
- `is_closed` (true/false): Whether its status counts as closed
- `is_private` (true/false): Whether only its author, assignee and some roles see it
- `link` (text): A link to it in Redmine
- `parent_id` (number): Its parent issue's number; 0 if none
- `priority` (text): Its priority, such as Normal or High
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `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 Resolved
- `subject` (text): Its one-line summary
- `target_version` (text): The version it's planned for; empty if none
- `tracker` (text): Its tracker, such as Bug or Feature
- `updated_on` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "assignee": "Sam Patel",
  "assignee_id": 7,
  "author": "Jane Doe",
  "author_id": 5,
  "category": "",
  "closed_on": "",
  "created_on": "2026-11-05T09:12:44Z",
  "custom_fields": {
    "Customer": "Acme Ltd"
  },
  "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
  "done_ratio": 30,
  "due_date": "2026-11-12",
  "estimated_hours": 4.0,
  "history": [
    {
      "changes": [
        "Status: New > In Progress",
        "% Done: 0 > 30"
      ],
      "created_on": "2026-11-05T14:03:10Z",
      "id": 1907,
      "notes": "Reproduced on Safari; looking at the mail settings.",
      "private_notes": false,
      "user": "Sam Patel",
      "user_id": 7
    }
  ],
  "id": 482,
  "is_closed": false,
  "is_private": false,
  "link": "https://redmine.example.com/issues/482",
  "parent_id": 0,
  "priority": "High",
  "project": "Website",
  "project_id": 3,
  "spent_hours": 1.5,
  "start_date": "2026-11-05",
  "status": "In Progress",
  "subject": "Contact form does not send",
  "target_version": "",
  "tracker": "Bug",
  "updated_on": "2026-11-05T14:03:10Z"
}
```

### List projects

List every project the connected user can see, with its identifier and whether it's open.

**Inputs**: None.

**Outputs**

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

**Example output**

```json
{
  "count": 1,
  "projects": [
    {
      "created_on": "2026-01-14T10:00:00Z",
      "description": "The company website",
      "id": 3,
      "identifier": "website",
      "is_public": false,
      "link": "https://redmine.example.com/projects/website",
      "name": "Website",
      "parent": "",
      "parent_id": 0,
      "status": "active"
    }
  ]
}
```

### Log time

Log hours spent on an issue or a project.

**Inputs**

- Hours (`hours`, number, required): How long, in hours, such as 1.5. From 0.01 to 1000.
- Issue (`issue`, text): The issue the time was spent on: its number or link. Leave blank to log it on the project.
- Project (`project`, text): The project the time was spent on, when it isn't on one issue.
- Activity (`activity`, text): What kind of work, such as Development. Leave blank for Redmine's default.
- Date (`spent_on`, date): The day it was spent. Leave blank for today.
- Comment (`comments`, 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
- `comments` (text): What was done
- `created_on` (text): When it was logged (ISO 8601)
- `hours` (number): How many hours
- `id` (number): The time entry's ID
- `issue_id` (number): The issue's number; 0 if logged on the project
- `project` (text): The project the time was spent on
- `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

**Example output**

```json
{
  "activity": "Development",
  "comments": "Fixed the mail settings",
  "created_on": "2026-11-05T16:00:00Z",
  "hours": 1.5,
  "id": 2201,
  "issue_id": 482,
  "project": "Website",
  "project_id": 3,
  "spent_on": "2026-11-05",
  "user": "Sam Patel",
  "user_id": 7
}
```

### Update issue

Change an issue's status, assignee, priority, % done, dates or other fields, with a note saying why.

**Inputs**

- Issue (`issue`, text, required): The issue's number, such as 482, or its link.
- Status (`status`, text): Move it to this status, such as Resolved. Leave blank to keep it.
- Assignee (`assignee`, text): Who to assign it to: a name, login 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.
- % Done (`done_ratio`, number): How far done it is, from 0 to 100. Leave blank to keep it. From 0 to 100.
- Note (`notes`, text): A note to add with the change, saying why.
- Private note (`private_notes`, true/false): Only roles allowed to see private notes see the note.
- Subject (`subject`, text): A new one-line summary. Leave blank to keep it.
- Description (`description`, text): A new description, replacing the old one. Leave blank to keep it.
- Tracker (`tracker`, text): Move it to this tracker. Leave blank to keep it.
- Start date (`start_date`, date): A new start date. Leave blank to keep it.
- Due date (`due_date`, date): A new due date. Leave blank to keep it.
- Estimated hours (`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 Redmine shows it, such as Customer: Acme Ltd.

**Outputs**

- `assignee` (text): Who it's assigned to; empty if nobody
- `assignee_id` (number): The assignee's ID; 0 if nobody
- `author` (text): Who opened it
- `author_id` (number): The ID of who opened it
- `category` (text): Its category; empty if none
- `closed_on` (text): When it was closed (ISO 8601); empty if open
- `created_on` (text): When it was opened (ISO 8601)
- `custom_fields` (object): Its custom fields' values, by field name
- `description` (text): Its description
- `done_ratio` (number): How far done it is, from 0 to 100
- `due_date` (text): Its due date (YYYY-MM-DD); empty if none
- `estimated_hours` (number): The hours estimated for it; 0 if none
- `id` (number): The issue's number
- `is_closed` (true/false): Whether its status counts as closed
- `is_private` (true/false): Whether only its author, assignee and some roles see it
- `link` (text): A link to it in Redmine
- `parent_id` (number): Its parent issue's number; 0 if none
- `priority` (text): Its priority, such as Normal or High
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `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 Resolved
- `subject` (text): Its one-line summary
- `target_version` (text): The version it's planned for; empty if none
- `tracker` (text): Its tracker, such as Bug or Feature
- `updated_on` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "assignee": "Sam Patel",
  "assignee_id": 7,
  "author": "Jane Doe",
  "author_id": 5,
  "category": "",
  "closed_on": "",
  "created_on": "2026-11-05T09:12:44Z",
  "custom_fields": {
    "Customer": "Acme Ltd"
  },
  "description": "Submitting the form on /contact shows a spinner and nothing arrives.",
  "done_ratio": 30,
  "due_date": "2026-11-12",
  "estimated_hours": 4.0,
  "id": 482,
  "is_closed": false,
  "is_private": false,
  "link": "https://redmine.example.com/issues/482",
  "parent_id": 0,
  "priority": "High",
  "project": "Website",
  "project_id": 3,
  "spent_hours": 1.5,
  "start_date": "2026-11-05",
  "status": "In Progress",
  "subject": "Contact form does not send",
  "target_version": "",
  "tracker": "Bug",
  "updated_on": "2026-11-05T14:03:10Z"
}
```
