# YouTrack

> Work with your YouTrack issues: search, read, create, update and delete issues, run commands on them, comment, tag, and look up projects and users.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/youtrack

## Actions

### Add comment

Comment on an issue. Markdown works.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Comment (`text`, text, required): The comment's text.

**Outputs**

- `comment` (object): The comment
- `issue_id` (text): The issue commented on

**Example output**

```json
{
  "comment": {
    "author": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "created": "2026-10-15T10:00:00Z",
    "id": "4-22",
    "text": "I can reproduce this.",
    "updated": "2026-10-15T10:00:00Z"
  },
  "issue_id": "DEMO-7"
}
```

### Add tag to issue

Put an existing tag on an issue.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Tag (`tag`, text, required): The tag. Pick one, or give its name or id from an earlier step.

**Outputs**

- `issue_id` (text): The issue tagged
- `tag` (object): The tag

**Example output**

```json
{
  "issue_id": "DEMO-7",
  "tag": {
    "id": "6-0",
    "name": "regression"
  }
}
```

### Apply command

Run a YouTrack command on an issue, the way you would type it in the issue's command box: `State In Progress`, `for jo`, `vote`, `relates to DEMO-3`, `tag regression`. The result of the command is not returned; read the issue again to see it.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Command (`command`, text, required): The command to run.
- Comment (`comment`, text): A comment to add to the issue along with the command.
- Don't send notifications (`silent`, true/false): Apply the command without notifying watchers. Default: `false`.

**Outputs**

- `applied` (true/false): Always true once applied
- `command` (text): The command that ran
- `issue_id` (text): The issue changed

**Example output**

```json
{
  "applied": true,
  "command": "State In Progress",
  "issue_id": "DEMO-7"
}
```

### Create issue

Create an issue in a project. State, assignee, priority and type must be values the project allows.

**Inputs**

- Project (`project`, text, required): The project. Pick one, or give its short name (such as DEMO).
- Summary (`summary`, text, required): The issue's title.
- Description (`description`, text): The issue's description. Markdown works.
- State (`state`, text): A state the project allows, such as Open or In Progress. Leave empty to leave it as it is.
- Assignee (`assignee`, text): Who the issue is assigned to. Leave empty to leave it as it is.
- Priority (`priority`, text): A priority the project allows, such as Major or Minor.
- Type (`issue_type`, text): A type the project allows, such as Bug, Task or Feature.

**Outputs**

- `issue` (object): The issue

**Example output**

```json
{
  "issue": {
    "assignee": "jo",
    "comments_count": 1,
    "created": "2026-10-15T09:00:00Z",
    "description": "Steps to reproduce: open the login page.",
    "fields": {
      "Assignee": "Jo Bloggs",
      "Priority": "Major",
      "State": "Open"
    },
    "id": "2-14",
    "id_readable": "DEMO-7",
    "is_resolved": false,
    "priority": "Major",
    "project": {
      "id": "0-1",
      "name": "Demo project",
      "short_name": "DEMO"
    },
    "reporter": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "resolved": null,
    "state": "Open",
    "summary": "Login page shows a blank screen",
    "tags": [
      {
        "id": "6-0",
        "name": "regression"
      }
    ],
    "type": "Bug",
    "updated": "2026-10-16T09:00:00Z",
    "updater": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "url": "https://acme.youtrack.cloud/issue/DEMO-7",
    "votes": 0
  }
}
```

### Create tag

Create a tag that you own. It can then be put on issues.

**Inputs**

- Name (`name`, text, required): The tag's name.
- Remove when an issue is resolved (`untag_on_resolve`, true/false): Take the tag off an issue once it is resolved. Default: `false`.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "tag": {
    "id": "6-0",
    "name": "regression",
    "owner": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "untag_on_resolve": false
  }
}
```

### Delete comment

Delete a comment from an issue.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Comment ID (`comment_id`, text, required): The comment's id, from 'List comments' or 'Add comment'.

**Outputs**

- `comment_id` (text): The comment deleted
- `deleted` (true/false): Always true once deleted
- `issue_id` (text): The issue

**Example output**

```json
{
  "comment_id": "4-22",
  "deleted": true,
  "issue_id": "DEMO-7"
}
```

### Delete issue

Permanently delete an issue. It cannot be brought back.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `issue_id` (text): The issue deleted

**Example output**

```json
{
  "deleted": true,
  "issue_id": "DEMO-7"
}
```

### Delete tag

Delete a tag you own. It comes off every issue that has it.

**Inputs**

- Tag (`tag`, text, required): The tag. Pick one, or give its name or id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (text): The tag deleted

**Example output**

```json
{
  "deleted": true,
  "tag_id": "6-0"
}
```

### Get current user

Get the YouTrack user the connection acts as: login, name and email.

**Inputs**: None.

**Outputs**

- `user` (object): The user

**Example output**

```json
{
  "user": {
    "banned": false,
    "email": "jo@example.com",
    "full_name": "Jo Bloggs",
    "id": "1-1",
    "login": "jo"
  }
}
```

### Get issue

Get one issue with its description, state, assignee, priority, tags and every custom field.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.

**Outputs**

- `issue` (object): The issue

**Example output**

```json
{
  "issue": {
    "assignee": "jo",
    "comments_count": 1,
    "created": "2026-10-15T09:00:00Z",
    "description": "Steps to reproduce: open the login page.",
    "fields": {
      "Assignee": "Jo Bloggs",
      "Priority": "Major",
      "State": "Open"
    },
    "id": "2-14",
    "id_readable": "DEMO-7",
    "is_resolved": false,
    "priority": "Major",
    "project": {
      "id": "0-1",
      "name": "Demo project",
      "short_name": "DEMO"
    },
    "reporter": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "resolved": null,
    "state": "Open",
    "summary": "Login page shows a blank screen",
    "tags": [
      {
        "id": "6-0",
        "name": "regression"
      }
    ],
    "type": "Bug",
    "updated": "2026-10-16T09:00:00Z",
    "updater": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "url": "https://acme.youtrack.cloud/issue/DEMO-7",
    "votes": 0
  }
}
```

### Get project

Get one project with its short name, description and leader.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "project": {
    "archived": false,
    "description": "A sample project.",
    "id": "0-1",
    "leader": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "name": "Demo project",
    "short_name": "DEMO"
  }
}
```

### List comments

List an issue's comments, oldest first. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 42. From 1 to 100.
- Skip (`skip`, number): How many to skip, to get a later page. Use the 'next_skip' of the earlier page. At least 0.

**Outputs**

- `comments` (list): The comments
- `count` (number): How many came back on this page
- `has_more` (true/false): True if there may be more after this page
- `issue_id` (text): The issue
- `next_skip` (number): The 'Skip' to use to get the page after this one

**Example output**

```json
{
  "comments": [
    {
      "author": {
        "banned": false,
        "email": "jo@example.com",
        "full_name": "Jo Bloggs",
        "id": "1-1",
        "login": "jo"
      },
      "created": "2026-10-15T10:00:00Z",
      "id": "4-22",
      "text": "I can reproduce this.",
      "updated": "2026-10-15T10:00:00Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "issue_id": "DEMO-7",
  "next_skip": 1
}
```

### List projects

List the projects you can see, skipping archived ones unless asked. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Search (`query`, text): Only projects whose name matches.
- Include archived projects (`include_archived`, true/false): Also list projects that have been archived. Default: `false`.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 42. From 1 to 100.
- Skip (`skip`, number): How many to skip, to get a later page. Use the 'next_skip' of the earlier page. At least 0.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True if there may be more after this page
- `next_skip` (number): The 'Skip' to use to get the page after this one
- `projects` (list): The projects

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_skip": 1,
  "projects": [
    {
      "archived": false,
      "description": "A sample project.",
      "id": "0-1",
      "leader": {
        "banned": false,
        "email": "jo@example.com",
        "full_name": "Jo Bloggs",
        "id": "1-1",
        "login": "jo"
      },
      "name": "Demo project",
      "short_name": "DEMO"
    }
  ]
}
```

### List tags

List the tags you can see. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 42. From 1 to 100.
- Skip (`skip`, number): How many to skip, to get a later page. Use the 'next_skip' of the earlier page. At least 0.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True if there may be more after this page
- `next_skip` (number): The 'Skip' to use to get the page after this one
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_skip": 1,
  "tags": [
    {
      "id": "6-0",
      "name": "regression",
      "owner": {
        "banned": false,
        "email": "jo@example.com",
        "full_name": "Jo Bloggs",
        "id": "1-1",
        "login": "jo"
      },
      "untag_on_resolve": false
    }
  ]
}
```

### List users

List YouTrack users, optionally matching a name, login or email. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Search (`query`, text): Only users whose login, name or email matches.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 42. From 1 to 100.
- Skip (`skip`, number): How many to skip, to get a later page. Use the 'next_skip' of the earlier page. At least 0.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True if there may be more after this page
- `next_skip` (number): The 'Skip' to use to get the page after this one
- `users` (list): The users

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_skip": 1,
  "users": [
    {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    }
  ]
}
```

### Remove tag from issue

Take a tag off an issue. The tag itself stays.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Tag (`tag`, text, required): The tag. Pick one, or give its name or id from an earlier step.

**Outputs**

- `issue_id` (text): The issue
- `removed` (true/false): Always true once removed
- `tag_id` (text): The tag removed

**Example output**

```json
{
  "issue_id": "DEMO-7",
  "removed": true,
  "tag_id": "6-0"
}
```

### Search issues

Find issues with YouTrack's search, in one project or all of them. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Project (`project`, text): Only issues in this project. Leave empty to search them all.
- Search query (`query`, text): YouTrack's search, such as `assignee: me` or `summary: login`. Leave empty to list every issue.
- Only unresolved issues (`only_unresolved`, true/false): Leave out issues that are done. Default: `false`.
- Order (`sort`, text): How to sort the issues. Defaults to YouTrack's own order. One of: `default` (YouTrack's default order), `created desc` (Newest first), `created asc` (Oldest first), `updated desc` (Recently updated first), `updated asc` (Least recently updated first). Default: `default`.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 42. From 1 to 100.
- Skip (`skip`, number): How many to skip, to get a later page. Use the 'next_skip' of the earlier page. At least 0.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True if there may be more after this page
- `issues` (list): The issues
- `next_skip` (number): The 'Skip' to use to get the page after this one

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "issues": [
    {
      "assignee": "jo",
      "comments_count": 1,
      "created": "2026-10-15T09:00:00Z",
      "description": "Steps to reproduce: open the login page.",
      "fields": {
        "Assignee": "Jo Bloggs",
        "Priority": "Major",
        "State": "Open"
      },
      "id": "2-14",
      "id_readable": "DEMO-7",
      "is_resolved": false,
      "priority": "Major",
      "project": {
        "id": "0-1",
        "name": "Demo project",
        "short_name": "DEMO"
      },
      "reporter": {
        "banned": false,
        "email": "jo@example.com",
        "full_name": "Jo Bloggs",
        "id": "1-1",
        "login": "jo"
      },
      "resolved": null,
      "state": "Open",
      "summary": "Login page shows a blank screen",
      "tags": [
        {
          "id": "6-0",
          "name": "regression"
        }
      ],
      "type": "Bug",
      "updated": "2026-10-16T09:00:00Z",
      "updater": {
        "banned": false,
        "email": "jo@example.com",
        "full_name": "Jo Bloggs",
        "id": "1-1",
        "login": "jo"
      },
      "url": "https://acme.youtrack.cloud/issue/DEMO-7",
      "votes": 0
    }
  ],
  "next_skip": 1
}
```

### Update comment

Change the text of a comment.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Comment ID (`comment_id`, text, required): The comment's id, from 'List comments' or 'Add comment'.
- New text (`text`, text, required): The comment's new text.

**Outputs**

- `comment` (object): The comment
- `issue_id` (text): The issue commented on

**Example output**

```json
{
  "comment": {
    "author": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "created": "2026-10-15T10:00:00Z",
    "id": "4-22",
    "text": "Fixed in the next build.",
    "updated": "2026-10-15T10:00:00Z"
  },
  "issue_id": "DEMO-7"
}
```

### Update issue

Change an issue's summary, description, state, assignee, priority or type. Only the fields given change.

**Inputs**

- Issue ID (`issue_id`, text, required): The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Summary (`summary`, text): A new title. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.
- State (`state`, text): A state the project allows, such as Open or In Progress. Leave empty to leave it as it is.
- Assignee (`assignee`, text): Who the issue is assigned to. Leave empty to leave it as it is.
- Priority (`priority`, text): A priority the project allows, such as Major or Minor.
- Type (`issue_type`, text): A type the project allows, such as Bug, Task or Feature.

**Outputs**

- `issue` (object): The issue

**Example output**

```json
{
  "issue": {
    "assignee": "jo",
    "comments_count": 1,
    "created": "2026-10-15T09:00:00Z",
    "description": "Steps to reproduce: open the login page.",
    "fields": {
      "Assignee": "Jo Bloggs",
      "Priority": "Major",
      "State": "Open"
    },
    "id": "2-14",
    "id_readable": "DEMO-7",
    "is_resolved": false,
    "priority": "Major",
    "project": {
      "id": "0-1",
      "name": "Demo project",
      "short_name": "DEMO"
    },
    "reporter": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "resolved": null,
    "state": "Open",
    "summary": "Login page is fixed",
    "tags": [
      {
        "id": "6-0",
        "name": "regression"
      }
    ],
    "type": "Bug",
    "updated": "2026-10-16T09:00:00Z",
    "updater": {
      "banned": false,
      "email": "jo@example.com",
      "full_name": "Jo Bloggs",
      "id": "1-1",
      "login": "jo"
    },
    "url": "https://acme.youtrack.cloud/issue/DEMO-7",
    "votes": 0
  }
}
```
