Skip to main content
Columns are the top-level structural units of a NodeForgeCMS site. Every piece of content lives inside a column, which maps directly to a navigational section — think “Blog”, “About Us”, or “Products”. Each column has its own URL key, language setting, display order, and SEO metadata, making them the primary way you organise and expose content to visitors. Before you can publish articles, you need at least one column to assign them to.

List Columns

Returns all columns for the site. This is a public endpoint — no authentication is required.

Response


Get Column by URL Key

Returns a single column identified by its unique URL key. This is a public endpoint — no authentication is required.

Path Parameters

string
required
The column’s unique URL key (e.g. about, blog). This is the same value set in the urlkey field when the column was created.

Response


Create Column

Creates a new column. Requires a valid Bearer token.

Request Body

string
required
Display name for the column. Shown in navigation menus and column listings.
string
required
URL-safe path segment used to identify the column in routes (e.g. blog, about-us). Must be unique across all columns.
string
required
Language code for this column (e.g. en, zh, fr). Used to serve locale-specific content.
number
Display order relative to other columns. Lower numbers appear first. Defaults to the end of the list if omitted.
string
SEO meta title rendered in <title> for the column’s landing page.
string
SEO meta description rendered in <meta name="description"> for the column’s landing page.

Response


Update Column

Updates an existing column by its numeric ID. Requires a valid Bearer token.

Path Parameters

number
required
The numeric ID of the column to update.

Request Body

Accepts the same fields as Create Column. Supply only the fields you want to change — all fields will be replaced with the values provided.

Response


Delete Column

Permanently deletes a column by its numeric ID. Requires a valid Bearer token.

Path Parameters

number
required
The numeric ID of the column to delete.

Response

Deleting a column does not delete the articles assigned to it. Those articles remain in the database but become unassigned — they will no longer appear in column-filtered queries until reassigned to another column via the Articles API. Review and reassign orphaned articles before deleting a column in production.