Skip to main content
Articles are the core content objects in NodeForgeCMS. Every piece of published content — a blog post, a product description, a documentation page — is an article. Articles belong to a column, carry a language code for multi-locale sites, and can be in either published or draft state. The list and single-article endpoints are public for published content; all write operations require a Bearer token.

​
List Articles

Returns a paginated list of articles. Supports filtering by column, language, and publication status. This is a public endpoint — no authentication is required. 
GET /api/articles?page=1&limit=10&lang=en

​
Query Parameters

​
page
number
Page number to retrieve. Defaults to 1.
​
limit
number
Number of items to return per page. Defaults to 10.
​
columnId
number
Filter results to articles belonging to the specified column ID.
​
lang
string
Filter results by language code (e.g. en, zh). Returns articles of all languages when omitted.
​
status
string
Filter by publication status. Accepted values: published or draft. Unauthenticated requests should use published; omitting this parameter returns all accessible articles.

​
Response

{
  "code": 200,
  "data": {
    "list": [
      {
        "id": 1,
        "title": "Welcome to NodeForgeCMS",
        "summary": "An introduction to our new CMS platform",
        "coverImage": "/uploads/cover.jpg",
        "columnId": 1,
        "lang": "en",
        "status": "published",
        "createdAt": "2024-01-15T10:00:00Z"
      }
    ],
    "total": 42,
    "page": 1,
    "limit": 10
  },
  "message": "success"
}
FieldTypeDescription
listarrayArray of article summary objects for the current page
totalnumberTotal number of articles matching the applied filters
pagenumberCurrent page number
limitnumberMaximum items returned per page
The list response returns article summaries — the content (full HTML body) field is excluded for performance. Fetch a single article by ID to retrieve the full content.

​
Get Article by ID

Returns a single article including its full HTML content body. Published articles are publicly accessible. Draft articles require a valid Bearer token. 
GET /api/articles/1

​
Path Parameters

​
id
number
required
The numeric ID of the article to retrieve.

​
Response

{
  "code": 200,
  "data": {
    "id": 1,
    "title": "Welcome to NodeForgeCMS",
    "content": "<p>Full HTML content here...</p>",
    "summary": "An introduction",
    "coverImage": "/uploads/cover.jpg",
    "columnId": 1,
    "lang": "en",
    "status": "published",
    "seoTitle": "Welcome - Our CMS",
    "seoDescription": "Learn about our platform",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-16T08:30:00Z"
  },
  "message": "success"
}
FieldTypeDescription
idnumberUnique article identifier
titlestringArticle title
contentstringFull HTML body of the article
summarystringShort excerpt shown in listings
coverImagestringServer path to the cover image
columnIdnumberID of the parent column
langstringLanguage code
statusstringpublished — visible publicly; draft — hidden from public responses
seoTitlestringSEO meta title
seoDescriptionstringSEO meta description
createdAtstringISO 8601 creation timestamp
updatedAtstringISO 8601 last-updated timestamp

​
Create Article

Creates a new article. Requires a valid Bearer token. 
POST /api/articles
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "title": "Getting Started with NodeForgeCMS",
  "content": "<p>Here is the full article content...</p>",
  "summary": "A step-by-step guide to your first NodeForgeCMS setup",
  "coverImage": "/uploads/getting-started.jpg",
  "columnId": 1,
  "lang": "en",
  "status": "draft",
  "seoTitle": "Getting Started — NodeForgeCMS",
  "seoDescription": "Learn how to set up NodeForgeCMS in minutes"
}

​
Request Body

​
title
string
required
Article title displayed in listings, the article page, and browser tab.
​
content
string
required
Full HTML content body of the article. The CMS rich-text editor outputs standard HTML; you may also supply raw HTML directly.
​
summary
string
Short excerpt (plain text) shown in article listing cards and search previews.
​
coverImage
string
Server-relative path to the article’s cover image (e.g. /uploads/cover.jpg). Use the Media API to upload images and obtain a valid path.
​
columnId
number
required
The ID of the column this article belongs to. The column must exist before creating an article.
​
lang
string
required
Language code for the article (e.g. en, zh, fr). Should match the language of the parent column for consistent locale filtering.
​
status
string
Publication status. Accepted values: published (visible to the public) or draft (hidden from public responses). Defaults to draft if omitted — the article will not appear in public listing responses until explicitly set to published.
​
seoTitle
string
SEO meta title rendered in <title> for the article page. Falls back to title if omitted.
​
seoDescription
string
SEO meta description rendered in <meta name="description"> for the article page.

​
Response

{
  "code": 200,
  "data": {
    "id": 43,
    "title": "Getting Started with NodeForgeCMS",
    "columnId": 1,
    "lang": "en",
    "status": "draft",
    "createdAt": "2024-01-20T09:00:00Z"
  },
  "message": "success"
}

​
Update Article

Updates an existing article by its numeric ID. Requires a valid Bearer token. 
PUT /api/articles/43
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "title": "Getting Started with NodeForgeCMS",
  "content": "<p>Updated content body...</p>",
  "status": "published"
}

​
Path Parameters

​
id
number
required
The numeric ID of the article to update.

​
Request Body

Accepts the same fields as Create Article. Provide all fields you wish to persist — the record will be updated with the supplied values.

​
Response

{
  "code": 200,
  "data": {
    "id": 43,
    "title": "Getting Started with NodeForgeCMS",
    "columnId": 1,
    "lang": "en",
    "status": "published",
    "updatedAt": "2024-01-21T14:22:00Z"
  },
  "message": "success"
}

​
Delete Article

Permanently deletes an article by its numeric ID. Requires a valid Bearer token. 
DELETE /api/articles/43
Authorization: Bearer YOUR_TOKEN

​
Path Parameters

​
id
number
required
The numeric ID of the article to delete.

​
Response

{
  "code": 200,
  "data": null,
  "message": "success"
}
Article deletion is permanent and irreversible. There is no trash or soft-delete mechanism — once deleted, the article and its content cannot be recovered. Consider setting status to draft to hide content without permanently removing it.