From 23fd7180543a5ee117abbaeea7bf494501a9c30f Mon Sep 17 00:00:00 2001
From: wei-hai <2936715+wei-hai@users.noreply.github.com>
Date: Wed, 22 Jul 2026 22:34:02 +0000
Subject: [PATCH] chore(openapi): sync shared API contract from cloud@7e7e50d

---
 openapi.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openapi.yaml b/openapi.yaml
index a50312226..3daf23817 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -3313,7 +3313,7 @@ paths:
                         application/json:
                             schema:
                                 $ref: '#/components/schemas/PromptErrorResponse'
-                    description: Payment required - User has not paid
+                    description: 'Retryable backpressure. Two distinct causes, disambiguated by the body''s `error.type`, NOT by parsing `error.message`: `PAYMENT_REQUIRED` / `FREE_TIER_UNAVAILABLE` / `FREE_TIER_EXHAUSTED` / `PARTNER_NODE_PAYMENT_REQUIRED` (a billing gate - retrying without paying never succeeds), or `QUEUE_LIMIT` (this workspace''s bounded job queue is full - retrying after some queued jobs complete will succeed).'
                 "500":
                     content:
                         application/json: