YouTrack Standalone 2017.3 Help

Get an Issue

GET /issue/{issue}

Get issue by id

GET /rest/issue/{issue}?{wikifyDescription}

Request parameters:

Name

Type

Description

issue

issueById

ID of an issue to get.

wikifyDescription

boolean

Optional. If '

true
', then issue description in the response should be formatted ("wikified"). For example, the request URL with this parameter should look as follows: "
/rest/issue/jt-23?wikifyDescription=true
". By default, this parameter is '
false
' and skipped in the URL.

Response parameters:

Name

Description

id

Issue id in database

jiraId

If issue was imported from Jira, represents id, that it have in Jira

projectShortName

Short name of the issue's project

numberInProject

Number of issue in project

summary

Summary of the issue

description

Description of the issue

created

Time when issue was created (the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this date).

updated

Time when issue was last updated (the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this date).

updaterName

Login of the user, that was the last, who updated the issue

resolved

If the issue is resolved, shows time, when resolved state was last set to the issue (the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this date).

reporterName

Login of user, who created the issue

voterName

Login of user, that voted for issue

commentsCount

Number of comments in issue

votes

Number of votes for issue

permittedGroup

User group, that has permission to read this issue; if group is not set, it means that any user has access to this issue

comment

Represents issue comment (see Get Comments of an Issue)

tag

Tags, accessible to logged in user

field

Represent any field of the issue including custom fields (depending on name attribute). Number and type of fields depends on project settings.

Samples

Sample 1

Request

GET https://example.com/youtrack/rest/issue/HBR-63 Cookie: $Version=0; JSESSIONID=mk665rg7fe03cd1ma539knqg; $Path=/; jetbrains.charisma.main.security.PRINCIPAL=MTVhMjY2OGUxMTUxMTI5MGMzNjhlZWM5NTJiNGJkNmIyNzc3NjdjZmM3YWU4MTVjYzQwYWE1MWZlYTkwNTcxNzphcHBfZXhjZXB0aW9u; $Path=/

Response

HTTP/1.1 200 OK Content-Type: application/xml;charset=UTF-8 Content-Length: 1994 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <issue id="HBR-63"> <field name="attachments"> <value url="/_persistent/uploadFile.html?file=45-46&amp;v=0&amp;c=true">uploadFile.html</value> </field> <comment id="42-306" author="root" issueId="HBR-63" deleted="false" text="comment 1!" shownForIssueAuthor="false" created="1267030230127"> <replies/> </comment> <comment id="42-307" author="root" issueId="HBR-63" deleted="false" text="comment 2?" shownForIssueAuthor="false" created="1267030238721" updated="1267030230127"> <replies/> </comment> <field name="Priority"> <value>Normal</value> </field> <field name="Type"> <value>Bug</value> </field> <field name="State"> <value>Won't fix</value> </field> <field name="Assignee"> <value>beto</value> </field> <field name="Subsystem"> <value>Configuration</value> </field> <field name="Fix versions"> <value>2.0</value> <value>2.0.5</value> <value>2.0.7</value> </field> <field name="cf"> <value>0</value> <value>!</value> </field> <field name="scf"> <value>1265835603000</value> </field> <field name="links"> <value type="Depend" role="depends on">HBR-62</value> <value type="Duplicate" role="duplicates">HBR-57</value> <value type="Duplicate" role="is duplicated by">HBR-54</value> <value type="Relates" role="relates to">HBR-49</value> <value type="Relates" role="is related to">HBR-51</value> <value type="Depend" role="is required for">HBR-49</value> </field> <field name="projectShortName"> <value>HBR</value> </field> <field name="numberInProject"> <value>63</value> </field> <field name="summary"> <value>summary</value> </field> <field name="description"> <value>description</value> </field> <field name="created"> <value>1262171005630</value> </field> <field name="updated"> <value>1267630833573</value> </field> <field name="updaterName"> <value>root</value> </field> <field name="resolved"> <value>1267030108251</value> </field> <field name="reporterName"> <value>root</value> </field> <field name="commentsCount"> <value>2</value> </field> <field name="votes"> <value>0</value> </field> </issue>

Sample 2

Request

GET https://example.com/youtrack/rest/issue/HBR-650 Cookie: $Version=0; JSESSIONID=mk665rg7fe03cd1ma539knqg; $Path=/; jetbrains.charisma.main.security.PRINCIPAL=MTVhMjY2OGUxMTUxMTI5MGMzNjhlZWM5NTJiNGJkNmIyNzc3NjdjZmM3YWU4MTVjYzQwYWE1MWZlYTkwNTcxNzphcHBfZXhjZXB0aW9u; $Path=/

Response

HTTP/1.1 404 Not Found Content-Type: application/xml;charset=UTF-8 Content-Length: 86 <?xml version="1.0" encoding="UTF-8" standalone="yes"?><error>Issue not found.</error>
Last modified: 7 March 2019