Operations with Specific Issue
This resource lets you work with issues within the particular project.
Resource | |
|---|---|
Returned entity | Issue. For the description of the entity attributes, see Supported Fields section. |
Supported methods |
|
Represents an issue in YouTrack.
Below you can find the list of resources that let you work with this entity.
This table describes attributes of the Issue entity.
To receive an attribute in the response from the server, specify it explicitly in the
fieldsrequest 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. |
attachments | The list of attachments in the issue. | |
comments | A list of comments for the issue. | |
commentsCount | Int | The number of comments in the issue. |
created | Long | The timestamp in milliseconds indicating the moment when the issue was created. Stored as a unix timestamp at UTC. |
customFields | The collection of custom fields that are present in the issue. | |
description | String | The issue description. |
draftOwner | The creator of the draft if the issue is a draft. | |
externalIssue | Reference to the issue or similar object in an originating third-party system. | |
idReadable | String | The issue ID as seen in the YouTrack interface. |
isDraft | Boolean |
|
links | Issue links (for example, `relates to`, `parent for`, and so on). | |
numberInProject | Long | The issue number in the project. |
parent | The parent issue for the current one. If the issue is not a sub-task of any issue, then | |
pinnedComments | The list of comments that are pinned in the issue. | |
project | The project where the issue belongs. | |
reporter | The user who reported (created) the issue. | |
resolved | Long | The timestamp in milliseconds indicating the moment when the issue was assigned a state that is considered to be resolved. Stored as a unix timestamp at UTC. |
subtasks | The list of sub-tasks of the issue. | |
summary | String | The issue summary. |
tags | The list of tags that are added to the issue. | |
updated | Long | The timestamp in milliseconds indicating the last update of the issue. Stored as a unix timestamp at UTC. |
updater | The user who last updated the issue. | |
visibility | Visibility settings of the issue. They describe who is allowed to see the issue. | |
voters | Object that contains data about voters for the issue and for its duplicates. | |
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. |
watchers | Object that contains data about users watching this issue or its duplicates. | |
wikifiedDescription | String | The issue description as shown in the UI after processing wiki/Markdown markup (including HTML markup). |
Update a specific issue in the project.
Requires Create Issue permission for the issue reporter and Update Issue permission otherwise.
POST /api/admin/projects/{projectID}/issues/{issueID}?{fields}&{muteUpdateNotifications}{issueID} | Database ID of the issue. |
|---|
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 |
https://example.youtrack.cloud/api/admin/projects/0-6/issues/2-74?fields=id,idReadable,summary,description,customFields(id,name,value(id,name)){
"summary": "Sample: update an issue in specific project",
"description": "This issue is a sample for updating an issue in specific project. Using the `api/admin/projects/:id/issues/:id` endpoint.",
"customFields": [
{
"value": {
"name": "Major",
"$type": "EnumBundleElement"
},
"name": "Priority",
"id": "92-43",
"$type": "SingleEnumIssueCustomField"
},
{
"value": {
"name": "Task",
"$type": "EnumBundleElement"
},
"name": "Type",
"id": "92-44",
"$type": "SingleEnumIssueCustomField"
}
]
}{
"description": "This issue is a sample for updating an issue in specific project. Using the `api/admin/projects/:id/issues/:id` endpoint.",
"customFields": [
{
"value": {
"name": "Major",
"id": "67-2",
"$type": "EnumBundleElement"
},
"name": "Priority",
"id": "92-43",
"$type": "SingleEnumIssueCustomField"
},
{
"value": {
"name": "Task",
"id": "67-9",
"$type": "EnumBundleElement"
},
"name": "Type",
"id": "92-44",
"$type": "SingleEnumIssueCustomField"
},
{
"value": {
"name": "Submitted",
"id": "69-0",
"$type": "StateBundleElement"
},
"name": "State",
"id": "92-45",
"$type": "StateIssueCustomField"
},
{
"value": null,
"name": "Assignee",
"id": "94-6",
"$type": "SingleUserIssueCustomField"
},
{
"value": null,
"name": "Subsystem",
"id": "92-42",
"$type": "SingleOwnedIssueCustomField"
},
{
"value": [],
"name": "Fix versions",
"id": "92-46",
"$type": "MultiVersionIssueCustomField"
},
{
"value": [],
"name": "Affected versions",
"id": "92-47",
"$type": "MultiVersionIssueCustomField"
},
{
"value": null,
"name": "Fixed in build",
"id": "92-48",
"$type": "SingleBuildIssueCustomField"
}
],
"idReadable": "RP-6",
"summary": "Sample: update an issue in specific project",
"id": "2-74",
"$type": "Issue"
}Read a specific issue in the project.
GET /api/admin/projects/{projectID}/issues/{issueID}?{fields}{issueID} | Database ID of the issue. |
|---|
Parameter | Type | Description |
|---|---|---|
fields | String | A list of Issue attributes that should be returned in the response. If no field is specified, only the |
https://example.youtrack.cloud/api/admin/projects/0-6/issues/2-74?fields=id,idReadable,summary,description,customFields(id,name,value(id,name)){
"description": null,
"customFields": [
{
"value": {
"name": "Normal",
"id": "67-3",
"$type": "EnumBundleElement"
},
"name": "Priority",
"id": "92-43",
"$type": "SingleEnumIssueCustomField"
},
{
"value": {
"name": "Bug",
"id": "67-5",
"$type": "EnumBundleElement"
},
"name": "Type",
"id": "92-44",
"$type": "SingleEnumIssueCustomField"
},
{
"value": {
"name": "Submitted",
"id": "69-0",
"$type": "StateBundleElement"
},
"name": "State",
"id": "92-45",
"$type": "StateIssueCustomField"
},
{
"value": null,
"name": "Assignee",
"id": "94-6",
"$type": "SingleUserIssueCustomField"
},
{
"value": null,
"name": "Subsystem",
"id": "92-42",
"$type": "SingleOwnedIssueCustomField"
},
{
"value": [],
"name": "Fix versions",
"id": "92-46",
"$type": "MultiVersionIssueCustomField"
},
{
"value": [],
"name": "Affected versions",
"id": "92-47",
"$type": "MultiVersionIssueCustomField"
},
{
"value": null,
"name": "Fixed in build",
"id": "92-48",
"$type": "SingleBuildIssueCustomField"
}
],
"idReadable": "RP-6",
"summary": "Another sample for api/admin/projects/:id/issues endpoint",
"id": "2-74",
"$type": "Issue"
}Delete a specific issue in the project.
DELETE /api/admin/projects/{projectID}/issues/{issueID}{issueID} | Database ID of the issue. |
|---|
Parameter | Type | Description |
|---|---|---|
fields | String | A list of Issue attributes that should be returned in the response. If no field is specified, only the |
https://example.youtrack.cloud/api/admin/projects/0-6/issues/2-72