Blog

Write, schedule, publish, and distribute governed articles.

publicverified 2026-08-10blogeditorialpublishing

What It Is

Blog is Topolo's governed editorial workspace for article drafts, immutable revisions, publications, media, schedules, and SEO metadata. Sites consume its published article API instead of compiling copies of editorial content into their own repositories.

Architecture

Blog owns editorial truth and publishes headless reads. Consuming sites own presentation rather than maintaining copied article content.

Runtime Surfaces

The browser app is available at https://blog.topolo.app, with the editorial workspace under /articles and /articles/:articleId.

API Reference

Credential-scoped CLI and MCP clients discover typed actions through Topolo Developers for article, publication, media, settings, and privacy workflows.

Public publication routes expose published articles by publication key and slug without exposing draft or workspace data.

Auth and Permissions

Editorial browser and API routes use Topolo Auth, the topolo-blog service identity, and the selected Topolo workspace. Public routes are read-only and limited to published content.

Data Ownership

Blog owns organization- and workspace-scoped editorial data in D1 and media objects in R2. Scheduled publishing uses its queue and workflow bindings. Authorized organization export and erasure cover the owned editorial records and associated media lifecycle.

Deployments

Production is https://blog.topolo.app; staging is https://blog.stg.topolo.us; development is https://blog.topolo.dev.

Failure Modes

  • a scheduled article cannot enter its workflow or publication event queue
  • a published article references missing media
  • Developers action or store projections drift from the checked-in manifest

Debugging

Start with /systems/topolo-blog, verify the selected workspace and publication, then inspect the returned action error and recovery guidance.

Use It

Discover the service and its current credential-scoped actions before invoking one:

topolo services --query topolo-blog --json
topolo actions --service topolo-blog --json
topolo actions get app_topolo_blog.articles.list --json

Change Log / Verification

  • Added the canonical Blog application, action, storage, privacy, and publication documentation on 2026-08-10.