---
schema: rendered-html/v1
title: "Article | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-entity-Article.html
generated_at: 2026-06-11T14:45:08.340507+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](jetbrains__com__help__youtrack__devportal__api-entity-activitycategory.md)
- [ActivityCursorPage](jetbrains__com__help__youtrack__devportal__api-entity-activitycursorpage.md)
- [ActivityItem](jetbrains__com__help__youtrack__devportal__api-entity-activityitem.md)
- [Agile](jetbrains__com__help__youtrack__devportal__api-entity-agile.md)
- [AgileColumn](jetbrains__com__help__youtrack__devportal__api-entity-agilecolumn.md)
- [AgileSharingSettings](jetbrains__com__help__youtrack__devportal__api-entity-agilesharingsettings.md)
- [AgileStatus](jetbrains__com__help__youtrack__devportal__api-entity-agilestatus.md)
- [AppearanceSettings](jetbrains__com__help__youtrack__devportal__api-entity-appearancesettings.md)
- [ArticleAttachment](jetbrains__com__help__youtrack__devportal__api-entity-articleattachment.md)
- ArticleComment
- AssignedRole
- BackupError
- BackupFile
- BackupStatus
- BaseArticle
- [Article](api-entity-Article.html)
- 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
- GlobalTimeTrackingSettings
- Issue
- IssueAttachment
- 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. BaseArticle
5. [Article](#0)

# Article﻿

Last modified: 14 October 2024

Represents an article.

## Related Resources﻿

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

- Articles
- Parent Article
- Sub-articles
- Articles in a Project

Extends BaseArticle

## Attributes﻿

This table describes attributes of the `Article` 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 ID of the article. `Read-only`. |
| attachments | [Array of ArticleAttachments](jetbrains__com__help__youtrack__devportal__api-entity-articleattachment.md) | The list of files attached to the article. |
| childArticles | Array of Articles | The list of sub-articles of the current one. |
| comments | Array of ArticleComments | The list of comments to the article. |
| content | String | The content of the article. `Can be null`. |
| created | Long | The timestamp in milliseconds indicating the moment when the article was created. Stored as a unix timestamp at UTC. `Read-only`. |
| externalArticle | ExternalArticle | The reference to the article or a similar object in the originating third-party system. `Read-only`. `Can be null`. |
| hasChildren | Boolean | When `true`, the article has sub-articles. `Read-only`. |
| hasStar | Boolean | `true` if the current user added the "Star" tag to this article. Otherwise, `false`. |
| idReadable | String | The article ID. `Read-only`. |
| ordinal | Long | The position of the article in the tree. `Read-only`. |
| parentArticle | Article | The parent article of the current one. `Can be null`. |
| pinnedComments | Array of ArticleComments | The list of comments that are pinned in the article. `Read-only`. |
| project | Project | The project where the article belongs. `Read-only`. |
| reporter | User | The user who created the article. `Can be null`. |
| summary | String | The article title. `Can be null`. |
| tags | Array of Tags | The list of tags that are added to the article. |
| updated | Long | The timestamp in milliseconds indicating the last update of the article. Stored as a unix timestamp at UTC. `Read-only`. |
| updatedBy | User | The user who last updated the article. `Read-only`. `Can be null`. |
| visibility | Visibility | Visibility settings of the article. These settings describe who is allowed to see the article. `Can be null`. |

- [Article](/help/youtrack/devportal/api-entity-Article.html)
- [Related Resources](/help/youtrack/devportal/api-entity-Article.html#-44geco_3)
- [Attributes](/help/youtrack/devportal/api-entity-Article.html#-44geco_5)

BaseArticleBaseWorkItem

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

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