---
schema: rendered-html/v1
title: "Issue | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-entity-Issue.html
generated_at: 2026-06-11T14:49:54.060237+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
- AccessScope
- ActivityCategory
- ActivityCursorPage
- ActivityItem
- Agile
- AgileColumn
- AgileSharingSettings
- AgileStatus
- AppearanceSettings
- ArticleAttachment
- ArticleComment
- AssignedRole
- BackupError
- BackupFile
- BackupStatus
- BaseArticle
- BaseWorkItem
- Bundle
- BundleElement
- ChangesProcessor
- ColorCoding
- ColumnSettings
- CommandList
- CommandVisibility
- CustomField
- CustomFieldCondition
- CustomFieldDefaults
- DatabaseAttributeValue
- DatabaseBackupSettings
- DateFormatDescriptor
- DuplicateVote
- DurationValue
- EmailSettings
- Event
- ExternalArticle
- ExternalIssue
- FieldStyle
- FieldType
- FilterField
- GeneralUserProfile
- [GlobalSettings](jetbrains__com__help__youtrack__devportal__api-entity-globalsettings.md)
- [GlobalTimeTrackingSettings](jetbrains__com__help__youtrack__devportal__api-entity-globaltimetrackingsettings.md)
- [Issue](api-entity-Issue.html)
- [IssueAttachment](jetbrains__com__help__youtrack__devportal__api-entity-issueattachment.md)
- IssueComment
- IssueCountResponse
- IssueCustomField
- IssueFolder
- IssueKey
- IssueLink
- IssueLinkType
- IssueTimeTracking
- IssueVoters
- IssueWatcher
- IssueWatchers
- License
- LocaleDescriptor
- LocaleSettings
- Logo
- NotificationSettings
- NotificationsUserProfile
- OnlineUsers
- Organization
- ParsedCommand
- PeriodFieldFormat
- PeriodValue
- Permission
- ProjectColor
- ProjectCustomField
- ProjectTimeTrackingSettings
- PullRequest
- PullRequestChange
- PullRequestState
- Reaction
- RestCorsSettings
- Role
- SearchSuggestions
- Sprint
- SprintsSettings
- StorageEntry
- Suggestion
- SwimlaneSettings
- SwimlaneValue
- SystemSettings
- TagSharingSettings
- Telemetry
- TextFieldValue
- TimeTrackingUserProfile
- TimeZoneDescriptor
- User
- UserGroup
- UserProfiles
- UserType
- VcsChange
- VcsServer
- Visibility
- WIPLimit
- WatchFolderSharingSettings
- WorkItemAttribute
- WorkItemAttributePrototype
- WorkItemAttributeValue
- WorkItemProjectAttribute
- WorkItemType
- WorkTimeSettings
- Resources
- REST API Use Cases
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. REST API Reference
3. Entities
4. [Issue](#0)

# Issue﻿

Last modified: 14 October 2024

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](jetbrains__com__help__youtrack__devportal__api-entity-issueattachment.md) | 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`. |

- [Issue](/help/youtrack/devportal/api-entity-Issue.html)
- [Related Resources](/help/youtrack/devportal/api-entity-Issue.html#jnc27v_3)
- [Attributes](/help/youtrack/devportal/api-entity-Issue.html#jnc27v_4)

[GlobalTimeTrackingSettings](jetbrains__com__help__youtrack__devportal__api-entity-globaltimetrackingsettings.md)[IssueAttachment](jetbrains__com__help__youtrack__devportal__api-entity-issueattachment.md)

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

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