YouTrack

App · 19 actions

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

Actions

ActionWhat it does
Add commentComment on an issue.
Add tag to issuePut an existing tag on an issue.
Apply commandRun 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.
Create issueCreate an issue in a project.
Create tagCreate a tag that you own.
Delete commentDelete a comment from an issue.
Delete issuePermanently delete an issue.
Delete tagDelete a tag you own.
Get current userGet the YouTrack user the connection acts as: login, name and email.
Get issueGet one issue with its description, state, assignee, priority, tags and every custom field.
Get projectGet one project with its short name, description and leader.
List commentsList an issue's comments, oldest first.
List projectsList the projects you can see, skipping archived ones unless asked.
List tagsList the tags you can see.
List usersList YouTrack users, optionally matching a name, login or email.
Remove tag from issueTake a tag off an issue.
Search issuesFind issues with YouTrack's search, in one project or all of them.
Update commentChange the text of a comment.
Update issueChange an issue's summary, description, state, assignee, priority or type.

Add comment

Comment on an issue. Markdown works.

Inputs

Issue IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
CommenttexttextRequired
The comment's text.

Outputs

commentobject
The comment
issue_idtext
The issue commented on
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
TagtagtextRequired
The tag. Pick one, or give its name or id from an earlier step.

Outputs

issue_idtext
The issue tagged
tagobject
The tag
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
CommandcommandtextRequired
The command to run.
Commentcommenttext
A comment to add to the issue along with the command.
Don't send notificationssilenttrue/false
Apply the command without notifying watchers.Default: false.

Outputs

appliedtrue/false
Always true once applied
commandtext
The command that ran
issue_idtext
The issue changed
Example output
{
  "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

ProjectprojecttextRequired
The project. Pick one, or give its short name (such as DEMO).
SummarysummarytextRequired
The issue's title.
Descriptiondescriptiontext
The issue's description. Markdown works.
Statestatetext
A state the project allows, such as Open or In Progress. Leave empty to leave it as it is.
Assigneeassigneetext
Who the issue is assigned to. Leave empty to leave it as it is.
Priorityprioritytext
A priority the project allows, such as Major or Minor.
Typeissue_typetext
A type the project allows, such as Bug, Task or Feature.

Outputs

issueobject
The issue
Example output
{
  "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

NamenametextRequired
The tag's name.
Remove when an issue is resolveduntag_on_resolvetrue/false
Take the tag off an issue once it is resolved.Default: false.

Outputs

tagobject
The tag
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
Comment IDcomment_idtextRequired
The comment's id, from 'List comments' or 'Add comment'.

Outputs

comment_idtext
The comment deleted
deletedtrue/false
Always true once deleted
issue_idtext
The issue
Example output
{
  "comment_id": "4-22",
  "deleted": true,
  "issue_id": "DEMO-7"
}

Delete issue

Permanently delete an issue. It cannot be brought back.

Inputs

Issue IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.

Outputs

deletedtrue/false
Always true once deleted
issue_idtext
The issue deleted
Example output
{
  "deleted": true,
  "issue_id": "DEMO-7"
}

Delete tag

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

Inputs

TagtagtextRequired
The tag. Pick one, or give its name or id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
tag_idtext
The tag deleted
Example output
{
  "deleted": true,
  "tag_id": "6-0"
}

Get current user

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

Inputs

None.

Outputs

userobject
The user
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.

Outputs

issueobject
The issue
Example output
{
  "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

Projectproject_idtextRequired
The project. Pick one, or give its id.

Outputs

projectobject
The project
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 42.From 1 to 100.
Skipskipnumber
How many to skip, to get a later page. Use the 'next_skip' of the earlier page.At least 0.

Outputs

commentslist
The comments
countnumber
How many came back on this page
has_moretrue/false
True if there may be more after this page
issue_idtext
The issue
next_skipnumber
The 'Skip' to use to get the page after this one
Example output
{
  "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

Searchquerytext
Only projects whose name matches.
Include archived projectsinclude_archivedtrue/false
Also list projects that have been archived.Default: false.
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 42.From 1 to 100.
Skipskipnumber
How many to skip, to get a later page. Use the 'next_skip' of the earlier page.At least 0.

Outputs

countnumber
How many came back on this page
has_moretrue/false
True if there may be more after this page
next_skipnumber
The 'Skip' to use to get the page after this one
projectslist
The projects
Example output
{
  "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 sizelimitnumber
How many to return, 1 to 100. Defaults to 42.From 1 to 100.
Skipskipnumber
How many to skip, to get a later page. Use the 'next_skip' of the earlier page.At least 0.

Outputs

countnumber
How many came back on this page
has_moretrue/false
True if there may be more after this page
next_skipnumber
The 'Skip' to use to get the page after this one
tagslist
The tags
Example output
{
  "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

Searchquerytext
Only users whose login, name or email matches.
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 42.From 1 to 100.
Skipskipnumber
How many to skip, to get a later page. Use the 'next_skip' of the earlier page.At least 0.

Outputs

countnumber
How many came back on this page
has_moretrue/false
True if there may be more after this page
next_skipnumber
The 'Skip' to use to get the page after this one
userslist
The users
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
TagtagtextRequired
The tag. Pick one, or give its name or id from an earlier step.

Outputs

issue_idtext
The issue
removedtrue/false
Always true once removed
tag_idtext
The tag removed
Example output
{
  "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

Projectprojecttext
Only issues in this project. Leave empty to search them all.
Search queryquerytext
YouTrack's search, such as `assignee: me` or `summary: login`. Leave empty to list every issue.
Only unresolved issuesonly_unresolvedtrue/false
Leave out issues that are done.Default: false.
Ordersorttext
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 sizelimitnumber
How many to return, 1 to 100. Defaults to 42.From 1 to 100.
Skipskipnumber
How many to skip, to get a later page. Use the 'next_skip' of the earlier page.At least 0.

Outputs

countnumber
How many came back on this page
has_moretrue/false
True if there may be more after this page
issueslist
The issues
next_skipnumber
The 'Skip' to use to get the page after this one
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
Comment IDcomment_idtextRequired
The comment's id, from 'List comments' or 'Add comment'.
New texttexttextRequired
The comment's new text.

Outputs

commentobject
The comment
issue_idtext
The issue commented on
Example output
{
  "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 IDissue_idtextRequired
The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
Summarysummarytext
A new title. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Statestatetext
A state the project allows, such as Open or In Progress. Leave empty to leave it as it is.
Assigneeassigneetext
Who the issue is assigned to. Leave empty to leave it as it is.
Priorityprioritytext
A priority the project allows, such as Major or Minor.
Typeissue_typetext
A type the project allows, such as Bug, Task or Feature.

Outputs

issueobject
The issue
Example output
{
  "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
  }
}

On this page