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
| Action | What it does |
|---|---|
| Add comment | Comment on an issue. |
| Add tag to issue | Put an existing tag on an issue. |
| 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. |
| Create issue | Create an issue in a project. |
| Create tag | Create a tag that you own. |
| Delete comment | Delete a comment from an issue. |
| Delete issue | Permanently delete an issue. |
| Delete tag | Delete a tag you own. |
| Get current user | Get the YouTrack user the connection acts as: login, name and email. |
| Get issue | Get one issue with its description, state, assignee, priority, tags and every custom field. |
| Get project | Get one project with its short name, description and leader. |
| List comments | List an issue's comments, oldest first. |
| List projects | List the projects you can see, skipping archived ones unless asked. |
| List tags | List the tags you can see. |
| List users | List YouTrack users, optionally matching a name, login or email. |
| Remove tag from issue | Take a tag off an issue. |
| Search issues | Find issues with YouTrack's search, in one project or all of them. |
| Update comment | Change the text of a comment. |
| Update issue | Change an issue's summary, description, state, assignee, priority or type. |
Add comment
Comment on an issue. Markdown works.
Inputs
- Issue ID
issue_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
texttextRequired - 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 ID
issue_idtextRequired - The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Tag
tagtextRequired - 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 ID
issue_idtextRequired - The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Command
commandtextRequired - The command to run.
- Comment
commenttext - A comment to add to the issue along with the command.
- Don't send notifications
silenttrue/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
- Project
projecttextRequired - The project. Pick one, or give its short name (such as DEMO).
- Summary
summarytextRequired - The issue's title.
- Description
descriptiontext - The issue's description. Markdown works.
- State
statetext - A state the project allows, such as Open or In Progress. Leave empty to leave it as it is.
- Assignee
assigneetext - Who the issue is assigned to. Leave empty to leave it as it is.
- Priority
prioritytext - A priority the project allows, such as Major or Minor.
- Type
issue_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
- Name
nametextRequired - The tag's name.
- Remove when an issue is resolved
untag_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 ID
issue_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 ID
comment_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 ID
issue_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
- Tag
tagtextRequired - 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 ID
issue_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
- Project
project_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 ID
issue_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 size
limitnumber - How many to return, 1 to 100. Defaults to 42.From 1 to 100.
- Skip
skipnumber - 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
- Search
querytext - Only projects whose name matches.
- Include archived projects
include_archivedtrue/false - Also list projects that have been archived.Default:
false. - Page size
limitnumber - How many to return, 1 to 100. Defaults to 42.From 1 to 100.
- Skip
skipnumber - 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 size
limitnumber - How many to return, 1 to 100. Defaults to 42.From 1 to 100.
- Skip
skipnumber - 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
- Search
querytext - Only users whose login, name or email matches.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 42.From 1 to 100.
- Skip
skipnumber - 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 ID
issue_idtextRequired - The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Tag
tagtextRequired - 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
- Project
projecttext - Only issues in this project. Leave empty to search them all.
- Search query
querytext - YouTrack's search, such as `assignee: me` or `summary: login`. Leave empty to list every issue.
- Only unresolved issues
only_unresolvedtrue/false - Leave out issues that are done.Default:
false. - Order
sorttext - 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
limitnumber - How many to return, 1 to 100. Defaults to 42.From 1 to 100.
- Skip
skipnumber - 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 ID
issue_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 ID
comment_idtextRequired - The comment's id, from 'List comments' or 'Add comment'.
- New text
texttextRequired - 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 ID
issue_idtextRequired - The issue's ID, such as DEMO-7, from 'Search issues', 'Create issue' or an earlier step. An issue's address works too.
- Summary
summarytext - A new title. Leave empty to keep it.
- Description
descriptiontext - A new description. Leave empty to keep it.
- State
statetext - A state the project allows, such as Open or In Progress. Leave empty to leave it as it is.
- Assignee
assigneetext - Who the issue is assigned to. Leave empty to leave it as it is.
- Priority
prioritytext - A priority the project allows, such as Major or Minor.
- Type
issue_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
}
}