Skip to content

Article Object Intents

Purpose

This document defines the expected operating model for article objects managed through article-bff.

Role Of Article Objects

Article objects support:

  • long-form editorial content
  • article detail routes
  • collection membership
  • site-level article listings
  • search and retrieval workflows

Retrieval Intent

Use the live article BFF for retrieval:

  • getArticle
  • getArticleBySlug
  • listArticles

Mutation Intent

Use the live article BFF for mutation:

  • createArticle
  • updateArticle
  • deleteArticle

Current Contract Shape

As currently documented from live behavior, the usable article shape includes:

  • articleKey
  • slug
  • title
  • subtitle
  • body
  • heroImage
  • author
  • publishedAt
  • updatedAt

Operating Rules

  • The canonical slug is the slug returned by the BFF.
  • Site routing must use fetched BFF slugs, not speculative local identifiers.
  • Public article metadata must stay within the currently supported BFF shape.
  • Do not document local-only author or editorial fields as part of the authoritative article contract.