Articles API — Create and Manage Content in NodeForgeCMS

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

number

Page number to retrieve. Defaults to 1.

number

Number of items to return per page. Defaults to 10.

number

Filter results to articles belonging to the specified column ID.

string

Filter results by language code (e.g. en, zh). Returns articles of all languages when omitted.

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"
}

Field	Type	Description
`list`	array	Array of article summary objects for the current page
`total`	number	Total number of articles matching the applied filters
`page`	number	Current page number
`limit`	number	Maximum 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

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"
}

Field	Type	Description
`id`	number	Unique article identifier
`title`	string	Article title
`content`	string	Full HTML body of the article
`summary`	string	Short excerpt shown in listings
`coverImage`	string	Server path to the cover image
`columnId`	number	ID of the parent column
`lang`	string	Language code
`status`	string	`published` — visible publicly; `draft` — hidden from public responses
`seoTitle`	string	SEO meta title
`seoDescription`	string	SEO meta description
`createdAt`	string	ISO 8601 creation timestamp
`updatedAt`	string	ISO 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

string

required

Article title displayed in listings, the article page, and browser tab.

string

required

Full HTML content body of the article. The CMS rich-text editor outputs standard HTML; you may also supply raw HTML directly.

string

Short excerpt (plain text) shown in article listing cards and search previews.

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.

number

required

The ID of the column this article belongs to. The column must exist before creating an article.

string

required

Language code for the article (e.g. en, zh, fr). Should match the language of the parent column for consistent locale filtering.

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.

string

SEO meta title rendered in <title> for the article page. Falls back to title if omitted.

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

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

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.

Overview

Endpoints

Articles API — Create and Manage Content in NodeForgeCMS

List Articles

Query Parameters

Response

Get Article by ID

Path Parameters

Response

Create Article

Request Body

Response

Update Article

Path Parameters

Request Body

Response

Delete Article

Path Parameters

Response

​List Articles

​Query Parameters

​Response

​Get Article by ID

​Path Parameters

​Response

​Create Article

​Request Body

​Response

​Update Article

​Path Parameters

​Request Body

​Response

​Delete Article

​Path Parameters

​Response

List Articles

Query Parameters

Response

Get Article by ID

Path Parameters

Response

Create Article

Request Body

Response

Update Article

Path Parameters

Request Body

Response

Delete Article

Path Parameters

Response