KB Article Schema

Human-readable article number (server-generated, e.g. K-2026-00042)

Article title

URL-friendly slug (auto-generated from title if missing)

Article body (plain text or Markdown depending on bodyFormat)

Rich-text HTML body (sanitized server-side)

Content format used for rendering

Category label (free-text)

Optional structured category UUID

Workflow status

Publication flag (mirrors status === PUBLISHED)

Number of times the article has been viewed

Primary author user UUID (protected — assigned server-side)

Designated successor when the current author is offboarded

Visible in the customer portal

When non-empty, restricts portal visibility to these parties

Free-text tags

Owning kb_space UUID. Articles without a space appear in the default space.

Parent article UUID for hierarchy

Sort order among siblings under parentId

Materialized ancestor path (denormalized)

Denormalized root article UUID for share-based visibility

If true, this article acts as a template/blueprint

Emoji grapheme (e.g. "🚀") OR an Icons key from the shared set (e.g. "Server"). Rendered as an icon when the value matches an Icons key, otherwise as text.

Optional accent color for the article icon (hex, e.g. "#3b82f6")

Scheduled date for the next content review

Timestamp of the last completed review