From ab4f02ea5892bf5d4b09c7746fe05f7b62079a14 Mon Sep 17 00:00:00 2001
From: "molecule-ai[bot]" <276602405+molecule-ai[bot]@users.noreply.github.com>
Date: Tue, 21 Apr 2026 03:49:13 +0000
Subject: [PATCH] docs(blog): bootstrap-failed endpoint for platform monitoring
 (PR #1168)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Platform/ops angle. ~150 words. Social thread HELD — CP + Canvas parts
still pending (PR #1168 is Part 1 of 3). No user-facing UX in this release.
---
 .../index.mdx                                 | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 content/blog/2026-04-21-bootstrap-failed-endpoint/index.mdx

diff --git a/content/blog/2026-04-21-bootstrap-failed-endpoint/index.mdx b/content/blog/2026-04-21-bootstrap-failed-endpoint/index.mdx
new file mode 100644
index 0000000..010feb7
--- /dev/null
+++ b/content/blog/2026-04-21-bootstrap-failed-endpoint/index.mdx
@@ -0,0 +1,24 @@
+---
+title: "Monitor Workspace Bootstrap Failures with the bootstrap-failed Endpoint"
+description: "Molecule AI platform teams can now monitor workspace bootstrap failures via a dedicated AdminAuth-gated endpoint — no polling, no log scraping required."
+publishedAt: 2026-04-21
+tags: [platform, monitoring, workspaces, ops]
+---
+
+Platform teams running Molecule AI at scale need to know when workspaces fail to bootstrap — and why — without scraping logs or building custom polling logic.
+
+Starting today, the `bootstrap-failed` endpoint gives CP (Control Plane) a direct, authenticated path to monitor workspace provisioning failures. It's gated by AdminAuth, so only platform-level tooling can access it.
+
+**What it does:**
+
+- Lists all workspaces that reached a `failed` provisioning state
+- Returns the error reason, timestamp, and retry count for each
+- Supports filtering by org and time window
+
+**Why it matters:**
+
+Without this endpoint, monitoring workspace health meant either scraping agent logs or polling the workspace list and filtering by status client-side. Both approaches add latency and complexity. The `bootstrap-failed` endpoint makes failure monitoring a first-class platform concern.
+
+This is part one of a three-part feature set. The CP watcher UI and Canvas error panel integration follow in subsequent releases, which will surface the same data to end users.
+
+For platform teams running self-hosted Molecule AI: the endpoint is available in the latest release, gated behind AdminAuth credentials.