# Issue

Represents an issue in YouTrack.

## Related Resources

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

* [/api/issues](resource-api-issues.html)

* [/api/issues/{issueID}/links/{linkID}/issues](resource-api-issues-issueID-links-linkID-issues.html)

* [/api/admin/projects/{projectID}/issues](resource-api-admin-projects-projectID-issues.html)

## 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](api-entity-IssueAttachment.html)  |  The list of attachments in the issue.  |
|  comments  |  [Array of IssueComments](api-entity-IssueComment.html)  |  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](api-entity-IssueCustomField.html)  |  The collection of custom fields that are present in the issue. `Read-only`.  |
|  description  |  String  |  The issue description. `Can be null`.  |
|  draftOwner  |  [User](api-entity-User.html)  |  The creator of the draft if the issue is a draft. `null` if the issue is reported. `Read-only`. `Can be null`.  |
|  externalIssue  |  [ExternalIssue](api-entity-ExternalIssue.html)  |  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](api-entity-IssueLink.html)  |  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](api-entity-IssueLink.html)  |  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](api-entity-IssueComment.html)  |  The list of comments that are pinned in the issue. `Read-only`.  |
|  project  |  [Project](api-entity-Project.html)  |  The project where the issue belongs. `Can be null`.  |
|  reporter  |  [User](api-entity-User.html)  |  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](api-entity-IssueLink.html)  |  The list of sub-tasks of the issue. `Read-only`.  |
|  summary  |  String  |  The issue summary. `Can be null`.  |
|  tags  |  [Array of Tags](api-entity-Tag.html)  |  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](api-entity-User.html)  |  The user who last updated the issue. `Read-only`. `Can be null`.  |
|  visibility  |  [Visibility](api-entity-Visibility.html)  |  Visibility settings of the issue. They describe who is allowed to see the issue. `Can be null`.  |
|  voters  |  [IssueVoters](api-entity-IssueVoters.html)  |  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](api-entity-IssueWatchers.html)  |  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`.  |