# Project Articles

This resource lets you work with articles that belong to the project.
|  Resource  |     ```GENERIC /api/admin/projects/{projectID}/articles ```    |
| --- | --- |
|  Returned entity  |  [Article](api-entity-Article.html). For the description of the entity attributes, see [Supported Fields](#Article-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Project Articles](#get_all-Article-method).    |

## Article attributes

Represents an article.

### Related Resources

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

* [Articles](resource-api-articles.html)

* [Parent Article](resource-api-articles-articleID-parentArticle.html)

* [Sub-articles](resource-api-articles-articleID-childArticles.html)

* [Articles in a Project]()

Extends [BaseArticle](api-entity-BaseArticle.html)

### 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](api-entity-ArticleAttachment.html)  |  The list of files attached to the article.  |
|  childArticles  |  [Array of Articles](api-entity-Article.html)  |  The list of sub-articles of the current one.  |
|  comments  |  [Array of ArticleComments](api-entity-ArticleComment.html)  |  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](api-entity-ExternalArticle.html)  |  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](api-entity-Article.html)  |  The parent article of the current one. `Can be null`.  |
|  pinnedComments  |  [Array of ArticleComments](api-entity-ArticleComment.html)  |  The list of comments that are pinned in the article. `Read-only`.  |
|  project  |  [Project](api-entity-Project.html)  |  The project where the article belongs. `Read-only`.  |
|  reporter  |  [User](api-entity-User.html)  |  The user who created the article. `Can be null`.  |
|  summary  |  String  |  The article title. `Can be null`.  |
|  tags  |  [Array of Tags](api-entity-Tag.html)  |  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](api-entity-User.html)  |  The user who last updated the article. `Read-only`. `Can be null`.  |
|  visibility  |  [Visibility](api-entity-Visibility.html)  |  Visibility settings of the article. These settings describe who is allowed to see the article. `Can be null`.  |

## Read a List of Articles

Get the list of articles that belong to the project.

### Request syntax

```GENERIC
GET /api/admin/projects/{projectID}/articles?{fields}&{$top}&{$skip}
```

|  null  |  The database ID of Article  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of Article attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.  |
|  $skip  |  Int  |  Optional. Lets you set a number of returned entities to skip before returning the first one.  |
|  $top  |  Int  |     Optional. Lets you specify the maximum number of entries that are returned in the response. If you don't set the $top value, the server limits the maximum number of returned entries.       The server returns a maximum of 42 entries for most resources that return collections. For more information, see [Pagination](api-concept-pagination.html).     |

### Sample

#### Sample request

```CURL
https://example.youtrack.cloud/api/admin/projects/81-1/articles?fields=id,summary,reporter(login)
```

#### Sample response body

```JSON
[
  {
    "summary": "The Tutorial for the Feature Development",
    "reporter": {
      "login": "sarah.jane",
      "$type": "User"
    },
    "id": "226-0",
    "$type": "Article"
  },
  {
    "summary": "Monitoring Responsibilities",
    "reporter": {
      "login": "john.smith",
      "$type": "User"
    },
    "id": "226-5",
    "$type": "Article"
  },
  {
    "summary": "Testing F.A.Q.",
    "reporter": {
      "login": "sarah.jane",
      "$type": "User"
    },
    "id": "226-6",
    "$type": "Article"
  },
  {
    "summary": "Documentation Style Guide",
    "reporter": {
      "login": "minnie.terry",
      "$type": "User"
    },
    "id": "226-21",
    "$type": "Article"
  }
]
```