# Introduction

## Article model

### Example

```json
{
   "id": 15,
   "category_id": 1,
   "status": "draft",
   "pinned": false,
   "position": 1,
   "title": "Title",
   "description": "<html>Html content</html>",
   "lead": null,
   "image_url": "http://image.url",
   "published_at": "2021-07-14T12:54:07.076Z",
   "created_at": "2021-07-14T12:54:07.076Z"
}
```

### Definition

Key | Type | Optional | Description
--------- | --------- | --------- | ---------
id | integer | no |
category_id | integer | yes |
status | enum: `['draft', 'published']` | no |
pinned | bool | no |
position | integer | yes |
title | string | no |
description | string | no |
lead | string | yes | currently not used
created_at | datetime | no | Time of creation
published_at | datetime | yes | Time of publication
image_url | string | yes |

## Category with articles model

### Example

```json
{
    "id": 10,
    "name": "News",
    "position": 2,
    "created_at": "2021-12-09T16:05:15.233Z",
    "active": true,
    "articles": [
        {
            "id": 16,
            "category_id": 10,
            "status": "published",
            "pinned": false,
            "title": "Title",
            "description": "<html>Html content</html>",
            "lead": null,
            "image_url": "http://image.url",
            "published_at": "2021-11-22T13:30:39.152Z",
            "created_at": "2021-08-27T10:37:50.306Z",
            "position": 1
        },
        ...
    ]
 }
```

### Definition

Key | Type | Optional | Description
--------- | --------- | --------- | ---------
id | integer | no |
name | string | yes |
position | integer | yes |
created_at | datetime | no | Time of creation
active | bool | no |
articles | array | no | Array of [Articles](doc-341735#article-model)