chore(openapi): sync shared API contract from cloud@71b8a97

2026-07-16 19:38:27 +08:00 · 2026-07-15 20:55:49 +00:00 · 2026-07-15 20:55:49 +00:00 · 07b66f4438
commit 07b66f4438
parent 87d23b8176
1 changed files with 17 additions and 0 deletions
--- 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