From 07b66f4438127cc5c3205f7b9db4cde3491e3ebb Mon Sep 17 00:00:00 2001
From: dante01yoon <6510430+dante01yoon@users.noreply.github.com>
Date: Wed, 15 Jul 2026 20:55:49 +0000
Subject: [PATCH] chore(openapi): sync shared API contract from cloud@71b8a97

---
 openapi.yaml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/openapi.yaml b/openapi.yaml
index e00643bad..94e9aa475 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -2464,6 +2464,23 @@ paths:
                             schema:
                                 additionalProperties: true
                                 properties:
+                                    free_tier_balance:
+                                        description: Free-tier job allowance for an authenticated non-paid (FREE-tier) user in the rollout. Absent for paid users and unauthenticated requests. Synthesized from config before a grant row exists so a brand-new user still sees their full allowance.
+                                        properties:
+                                            allowance:
+                                                description: Total free jobs granted for the current period
+                                                type: integer
+                                            remaining:
+                                                description: Free jobs remaining (allowance - used, floored at 0)
+                                                type: integer
+                                            used:
+                                                description: Free jobs consumed so far
+                                                type: integer
+                                        required:
+                                            - allowance
+                                            - used
+                                            - remaining
+                                        type: object
                                     max_upload_size:
                                         description: Maximum upload size in bytes
                                         type: integer