---
schema: rendered-html/v1
title: "Operations with Specific Issue | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/operations-api-issues.html
generated_at: 2026-06-11T15:07:35.474111+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- YouTrack REST API
- Get Started with REST API
- REST API Reference
- Entities
- Resources
- Activity Items
- Issue Activities Page
- Build Bundles
- Enum Bundles
- Owned Bundles
- State Bundles
- User Bundles
- Version Bundles
- Custom Fields
- Field Types
- Backup Files
- Database Backup Settings
- Global Settings
- Organizations
- Projects
- Telemetry data
- Global Time Tracking Settings
- Agiles
- Articles
- Assigned Roles
- Commands
- Command Suggestions
- User Groups
- Issue Link Types
- Issue Tag
- Issues
- [Operations with Specific Issue](operations-api-issues.html)
- Sub-resources
- Issue Count
- Permissions
- Roles
- Saved Queries
- Search Suggestions
- Tags
- Users
- My User Profile
- Issue Work Items
- REST API Use Cases
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. REST API Reference
3. Resources
4. Issues
5. [Operations with Specific Issue](#0)

# Operations with Specific Issue﻿

Last modified: 19 March 2025

Resource that provides access to issues.

| Resource | ``` /api/issues/{issueID} ``` |
| Returned entity | Issue. For the description of the entity attributes, see [Supported Fields](/help/youtrack/devportal/operations-api-issues.html#Issue-supported-fields) section. |
| Supported methods | - `GET`: [Read a Specific Issue](/help/youtrack/devportal/operations-api-issues.html#get-Issue-method). - `POST`: [Update a Specific Issue](/help/youtrack/devportal/operations-api-issues.html#update-Issue-method). - `DELETE`: [Delete a Specific Issue](/help/youtrack/devportal/operations-api-issues.html#delete-Issue-method). |

## Issue attributes﻿

Represents an issue in YouTrack.

### Related Resources﻿

Below you can find the list of resources that let you work with this entity.

- /api/issues
- /api/issues/{issueID}/links/{linkID}/issues
- /api/admin/projects/{projectID}/issues

### Attributes﻿

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. `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﻿

Read an issue with specific ID.

### Required permissions﻿

Requires permissions: Read Issue. If issue visibility is limited to some users or groups, user should be a part of this set or have Override Visibility Restrictions permission. For issue reporter only Create Issue permission is required.

### Request syntax﻿

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

| {issueID} | ID of the issue. You can specify either the database ID of the issue (for example, `2-24`) or issue ID in the project (for example, `TST-5`). |

### 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 `entityID` is returned. |

### Sample﻿

#### Sample request﻿

```
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))
```

#### Sample response body﻿

```
{
  "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﻿

Update single issue.

### Required permissions﻿

Requires Create Issue permission for issue's reporter and Update Issue permission otherwise.

### Request syntax﻿

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

| {issueID} | ID of the issue. You can specify either the database ID of the issue (for example, `2-24`) or issue ID in the project (for example, `TST-5`). |

### 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 `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﻿

#### Sample request﻿

```
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))
```

#### Sample request body﻿

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

#### Sample response body﻿

```
{
  "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 the issue. Note that this operation can not be undone.

### Required permissions﻿

Requires permissions: Delete Issue

### Request syntax﻿

```
DELETE /api/issues/{issueID}
```

| {issueID} | ID of the issue. You can specify either the database ID of the issue (for example, `2-24`) or issue ID in the project (for example, `TST-5`). |

### 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 `entityID` is returned. |

### Sample﻿

#### Sample request﻿

```
https://example.youtrack.cloud/api/issues/2-5
```

- [Operations with Specific Issue](/help/youtrack/devportal/operations-api-issues.html)
- [Issue attributes](/help/youtrack/devportal/operations-api-issues.html#Issue-supported-fields)
- [Read a Specific Issue](/help/youtrack/devportal/operations-api-issues.html#get-Issue-method)
- [Update a Specific Issue](/help/youtrack/devportal/operations-api-issues.html#update-Issue-method)
- [Delete a Specific Issue](/help/youtrack/devportal/operations-api-issues.html#delete-Issue-method)

IssuesIssue Activity Items

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.

![](https://bat.bing.com/action/0?ti=5220035&tm=gtm002&Ver=2&mid=aea3ebe4-e23e-404b-a51a-36c5e7dba43c&bo=4&sid=452929b065a111f19a7fe7356f74a419&vid=aa3122f0648711f1a10d6d095e10fd87&vids=0&msclkid=N&pi=918639831&lg=en-US&sw=1920&sh=1080&sc=24&tl=Operations%20with%20Specific%20Issue%20%7C%20Developer%20Portal%20for%20YouTrack%20and%20Hub%20Documentation&p=https%3A%2F%2Fwww.jetbrains.com%2Fhelp%2Fyoutrack%2Fdevportal%2Foperations-api-issues.html&r=&lt=1096&pt=1781190452410,30,30,,,2,2,2,2,2,,2,26,27,34,241,241,241,1094,1095,1096&pn=0,0&evt=pageLoad&sv=2&asc=G&cdb=AQAS&rn=513061)
