From 3679a6eff6be93073cb55b3c53de712daf324690 Mon Sep 17 00:00:00 2001 From: Hongming Wang Date: Mon, 27 Apr 2026 04:30:46 -0700 Subject: [PATCH] docs(saas-federation): fix workspace-limit response code (409, not 402) (#1754) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Quota gates are resource-state conflicts, not payment failures — RFC 9110 reserves 402 for billing/payment failures specifically. The canonical Molecule-AI/docs PR #82 already shipped the corrected text; this brings the molecule-core copy of the tutorial in line. The inline parenthetical "(not 402 Payment Required — quota gates are resource-state conflicts, not payment failures, per RFC 9110)" doubles as a regression anchor: a future edit that flips 409 back to 402 would have to also reword that explanation, making the change a deliberate two-step act rather than a casual oversight. Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/tutorials/saas-federation/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/saas-federation/index.md b/docs/tutorials/saas-federation/index.md index dfadb2b2..ace73e76 100644 --- a/docs/tutorials/saas-federation/index.md +++ b/docs/tutorials/saas-federation/index.md @@ -185,7 +185,7 @@ curl -X PATCH https://api.moleculesai.app/cp/orgs/acme \ }' ``` -When a tenant hits their workspace limit, `POST /workspaces` returns `402 Payment Required` with a message pointing them to upgrade. +When a tenant hits their workspace limit, `POST /workspaces` returns **`409 Conflict`** (not `402 Payment Required` — quota gates are resource-state conflicts, not payment failures, per RFC 9110). The response body's `error` field carries an upgrade hint. ---