Operations with Specific Issue
This resource lets you work with issues within the particular project.
Resource | /api/admin/projects/{projectID}/issues/{issueID} |
Returned entity | Issue. For the description of the entity attributes, see Supported Fields section. |
Supported methods |
|
Issue attributes
Represents an issue in YouTrack.
This table describes attributes of the Issue
entity.
To receive an attribute in the response from the server, specify it explicitly in the
fields
request parameter.To update an attribute, provide it in the body of a POST request.
Field | Type | Description |
---|---|---|
id | String | The database ID of the issue. |
idReadable | String | The issue ID as seen in the YouTrack interface. |
created | Long | The timestamp of the moment when the issue was created. |
updated | Long | The timestamp of the last update of the issue. |
resolved | Long | The timestamp of the moment when the issue was assigned a state that is considered to be resolved. |
numberInProject | Long | The issue number in the project. |
project | Project | The project where the issue belongs. |
summary | String | The issue summary. |
description | String | The issue description. |
wikifiedDescription | String | The issue description as shown in the UI after processing wiki/Markdown markup (including HTML markup). |
reporter | User | The user who reported (created) the issue. |
updater | User | The user who last updated the issue. |
draftOwner | User | The creator of the draft if the issue is a draft. |
isDraft | Boolean | |
visibility | Visibility | Visibility settings of the issue. They describe who is allowed to see the issue. |
votes | Int | The sum of votes for this issue and votes for its duplicates. A reporter of a duplicate issue automatically becomes a voter for the main issue. |
comments | Array of IssueComments | A list of comments for the issue. |
commentsCount | Int | The number of comments in the issue. |
tags | Array of IssueTags | The list of tags that are added to the issue. |
links | Array of IssueLinks | Issue links (for example, `relates to`, `parent for`, and so on). |
externalIssue | ExternalIssue | Reference to the issue or similar object in an originating third-party system. |
customFields | Array of IssueCustomFields | The collection of custom fields that are present in the issue. |
voters | IssueVoters | Object that contains data about voters for the issue and for its duplicates. |
watchers | IssueWatchers | Object that contains data about users watching this issue or its duplicates. |
attachments | Array of IssueAttachments | The list of attachments in the issue. |
subtasks | IssueLink | The list of sub-tasks of the issue. |
parent | IssueLink | The parent issue for the current one. If the issue is not a sub-task of any issue, then |
Update a Specific Issue
Update a specific issue in the project.
Required permissions
Requires Create Issue permission for the issue reporter and Update Issue permission otherwise.
Request syntax
{issueID} | Database ID of the issue. |
Request parameters
Parameter | Type | Description |
---|---|---|
fields | String | A list of Issue attributes that should be returned in the response. If no field is specified, only the |
muteUpdateNotifications | Boolean | Set this parameter to |
Sample
Sample request
Sample request body
Sample response body
Read a Specific Issue
Read a specific issue in the project.
Request syntax
{issueID} | Database ID of the issue. |
Request parameters
Parameter | Type | Description |
---|---|---|
fields | String | A list of Issue attributes that should be returned in the response. If no field is specified, only the |
Sample
Sample request
Sample response body
Delete a Specific Issue
Delete a specific issue in the project.
Request syntax
{issueID} | Database ID of the issue. |
Request parameters
Parameter | Type | Description |
---|---|---|
fields | String | A list of Issue attributes that should be returned in the response. If no field is specified, only the |