Operations with Specific Issue

Last modified: 11 March 2025

Resource	`/api/issues/{issueID}`
Returned entity	Issue. For the description of the entity attributes, see Supported Fields section.
Supported methods	`GET`: Read a Specific Issue. `POST`: Update a Specific Issue. `DELETE`: Delete a Specific Issue.

Issue attributes

Attributes

This table describes attributes of the Issue entity.

Field	Type	Description
id	String	The database ID of the issue. `Read-only`.
attachments	Array of IssueAttachments	The list of attachments in the issue.
comments	Array of IssueComments	A list of comments for the issue.
commentsCount	Int	The number of comments in the issue. `Read-only`.
created	Long	The timestamp in milliseconds indicating the moment when the issue was created. Stored as a unix timestamp at UTC. `Read-only`.
customFields	Array of IssueCustomFields	The collection of custom fields that are present in the issue. `Read-only`.
description	String	The issue description. `Can be null`.
draftOwner	User	The creator of the draft if the issue is a draft. `null` if the issue is reported. `Read-only`. `Can be null`.
externalIssue	ExternalIssue	Reference to the issue or similar object in an originating third-party system. `Read-only`. `Can be null`.
idReadable	String	The issue ID as seen in the YouTrack interface. `Read-only`.
isDraft	Boolean	`true` if this issue is a draft, `false` if it is reported. `Read-only`.
links	Array of IssueLinks	Issue links (for example, `relates to`, `parent for`, and so on). `Read-only`.
numberInProject	Long	The issue number in the project. `Read-only`.
parent	IssueLink	The parent issue for the current one. If the issue is not a sub-task of any issue, then `null`. `Read-only`.
pinnedComments	Array of IssueComments	The list of comments that are pinned in the issue. `Read-only`.
project	Project	The project where the issue belongs. `Can be null`.
reporter	User	The user who reported (created) the issue. `Read-only`. `Can be null`.
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. `null` if the issue is still in an unresolved state. `Read-only`. `Can be null`.
subtasks	IssueLink	The list of sub-tasks of the issue. `Read-only`.
summary	String	The issue summary. `Can be null`.
tags	Array of 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. `Read-only`.
updater	User	The user who last updated the issue. `Read-only`. `Can be null`.
visibility	Visibility	Visibility settings of the issue. They describe who is allowed to see the issue. `Can be null`.
voters	IssueVoters	Object that contains data about voters for the issue and for its duplicates. `Read-only`.
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. `Read-only`.
watchers	IssueWatchers	Object that contains data about users watching this issue or its duplicates. `Read-only`.
wikifiedDescription	String	The issue description as shown in the UI after processing wiki/Markdown markup (including HTML markup). `Read-only`.

Read a Specific Issue

GET /api/issues/{issueID}?{fields}

Parameter	Type	Description
fields	String	A list of Issue attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.

Sample

https://example.youtrack.cloud/api/issues/SP-38?fields=id,summary,customFields(id,name,value(avatarUrl,buildLink,color(id),fullName,id,isResolved,localizedName,login,minutes,name,presentation,text))

{
  "summary": "Sprint 3. Task 2",
  "customFields": [
    {
      "value": {
        "localizedName": null,
        "color": {
          "id": "17",
          "$type": "FieldStyle"
        },
        "name": "Normal",
        "id": "67-3",
        "$type": "EnumBundleElement"
      },
      "name": "Priority",
      "id": "92-1",
      "$type": "SingleEnumIssueCustomField"
    },
    {
      "value": {
        "localizedName": null,
        "color": {
          "id": "0",
          "$type": "FieldStyle"
        },
        "name": "Bug",
        "id": "67-5",
        "$type": "EnumBundleElement"
      },
      "name": "Type",
      "id": "92-2",
      "$type": "SingleEnumIssueCustomField"
    },
    {
      "value": {
        "isResolved": false,
        "localizedName": null,
        "color": {
          "id": "0",
          "$type": "FieldStyle"
        },
        "name": "Open",
        "id": "69-1",
        "$type": "StateBundleElement"
      },
      "name": "State",
      "id": "92-3",
      "$type": "StateIssueCustomField"
    },
    {
      "value": {
        "login": "john.doe",
        "avatarUrl": "/hub/api/rest/avatar/cd939d5e-4c15-4080-98cd-0cde0cb3c19f?s=48",
        "fullName": "John Doe",
        "name": "John Doe",
        "id": "1-2",
        "$type": "User"
      },
      "name": "Assignee",
      "id": "94-0",
      "$type": "SingleUserIssueCustomField"
    },
    {
      "value": null,
      "name": "Subsystem",
      "id": "92-0",
      "$type": "SingleOwnedIssueCustomField"
    },
    {
      "value": [],
      "name": "Fix versions",
      "id": "92-4",
      "$type": "MultiVersionIssueCustomField"
    },
    {
      "value": [],
      "name": "Affected versions",
      "id": "92-5",
      "$type": "MultiVersionIssueCustomField"
    },
    {
      "value": null,
      "name": "Fixed in build",
      "id": "92-6",
      "$type": "SingleBuildIssueCustomField"
    }
  ],
  "id": "2-42",
  "$type": "Issue"
}

Update a Specific Issue

POST /api/issues/{issueID}?{fields}&{muteUpdateNotifications}

Parameter	Type	Description
fields	String	A list of Issue attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.
muteUpdateNotifications	Boolean	Set this parameter to `true` if no notifications should be sent on changes made by this request. This doesn't mute notifications sent by any workflow rules. Using this parameter requires Apply Commands Silently permission in all projects affected by the request. Available since 2021.3.

Sample

https://example.youtrack.cloud/api/issues/SP-38?fields=id,summary,customFields(id,name,value(avatarUrl,buildLink,color(id),fullName,id,isResolved,localizedName,login,minutes,name,presentation,text))

{
  "summary": "New summary",
  "customFields": [
    {
      "value": {
        "name": "Major"
      },
      "name": "Priority",
      "id": "92-1",
      "$type": "SingleEnumIssueCustomField"
    }
  ]
}

{
  "summary": "New summary",
  "customFields": [
    {
      "value": {
        "localizedName": null,
        "color": {
          "id": "18",
          "$type": "FieldStyle"
        },
        "name": "Major",
        "id": "67-2",
        "$type": "EnumBundleElement"
      },
      "name": "Priority",
      "id": "92-1",
      "$type": "SingleEnumIssueCustomField"
    },
    {
      "value": {
        "localizedName": null,
        "color": {
          "id": "0",
          "$type": "FieldStyle"
        },
        "name": "Bug",
        "id": "67-5",
        "$type": "EnumBundleElement"
      },
      "name": "Type",
      "id": "92-2",
      "$type": "SingleEnumIssueCustomField"
    },
    {
      "value": {
        "isResolved": false,
        "localizedName": null,
        "color": {
          "id": "0",
          "$type": "FieldStyle"
        },
        "name": "Open",
        "id": "69-1",
        "$type": "StateBundleElement"
      },
      "name": "State",
      "id": "92-3",
      "$type": "StateIssueCustomField"
    },
    {
      "value": {
        "login": "john.doe",
        "avatarUrl": "/hub/api/rest/avatar/cd939d5e-4c15-4080-98cd-0cde0cb3c19f?s=48",
        "fullName": "John Doe",
        "name": "John Doe",
        "id": "1-2",
        "$type": "User"
      },
      "name": "Assignee",
      "id": "94-0",
      "$type": "SingleUserIssueCustomField"
    },
    {
      "value": null,
      "name": "Subsystem",
      "id": "92-0",
      "$type": "SingleOwnedIssueCustomField"
    },
    {
      "value": [],
      "name": "Fix versions",
      "id": "92-4",
      "$type": "MultiVersionIssueCustomField"
    },
    {
      "value": [],
      "name": "Affected versions",
      "id": "92-5",
      "$type": "MultiVersionIssueCustomField"
    },
    {
      "value": null,
      "name": "Fixed in build",
      "id": "92-6",
      "$type": "SingleBuildIssueCustomField"
    }
  ],
  "id": "2-42",
  "$type": "Issue"
}

Delete a Specific Issue

DELETE /api/issues/{issueID}

Parameter	Type	Description
fields	String	A list of Issue attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.

Operations with Specific Issue﻿

Issue attributes﻿

Related Resources﻿

Attributes﻿

Read a Specific Issue﻿

Required permissions

Request syntax

Request parameters

Sample﻿

Sample request

Sample response body

Update a Specific Issue﻿

Required permissions

Request syntax

Request parameters

Sample﻿

Sample request

Sample request body

Sample response body

Delete a Specific Issue﻿

Required permissions

Request syntax

Request parameters

Sample﻿

Sample request

Operations with Specific Issue

Issue attributes

Related Resources

Attributes

Read a Specific Issue

Sample

Update a Specific Issue

Sample

Delete a Specific Issue

Sample