From dec005cc8e6daf86d7bcf2bc09eda8c1c5c6c0ea Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 21 Aug 2026 05:09:04 +0000
Subject: [PATCH] docs: add AI Collection Creator tier limits

---
 mintlify/docs/guides/ai-byok.mdx    | 16 ++++++++++------
 mintlify/docs/limits-and-quotas.mdx | 19 +++++++++++++++----
 2 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/mintlify/docs/guides/ai-byok.mdx b/mintlify/docs/guides/ai-byok.mdx
index 737e88ee..c1792223 100644
--- a/mintlify/docs/guides/ai-byok.mdx
+++ b/mintlify/docs/guides/ai-byok.mdx
@@ -28,14 +28,18 @@ If a BYOK key is used, no urBackend-side session cap applies. Groq's own rate li
 
 ## Plan-tier behavior
 
-| Plan | Personal Groq key allowed? | Platform-key AI sessions per month |
-| :--- | :--- | :--- |
-| Free | Yes | 5 |
-| Pro | Yes | 20 |
+The AI Query Builder and the AI Collection Creator (Schema Design) each have their own monthly counter on the platform key:
+
+| Plan | Personal Groq key allowed? | Query Builder requests per month | Collection Creator schema designs per month |
+| :--- | :--- | :--- | :--- |
+| Free | Yes | 5 | 1 |
+| Pro | Yes | 20 | 5 |
+
+Monthly counters reset on the first of each calendar month (UTC).
 
-The monthly counter resets on the first of each calendar month (UTC).
+Collection Creator chat sessions that use the platform key are also capped at **20 iterations per session**. BYOK requests are not subject to this per-session cap.
 
-Once your plan's platform-key cap is reached, further AI requests return `403 Forbidden` until either the counter resets or you configure a BYOK key.
+Once your plan's platform-key cap (monthly or per-session) is reached, further AI requests return `403 Forbidden` until either the counter resets or you configure a BYOK key.
 
 ## Get a Groq API key
 
diff --git a/mintlify/docs/limits-and-quotas.mdx b/mintlify/docs/limits-and-quotas.mdx
index c2ecf830..45160159 100644
--- a/mintlify/docs/limits-and-quotas.mdx
+++ b/mintlify/docs/limits-and-quotas.mdx
@@ -33,16 +33,27 @@ When your project approaches the database quota, writes may be rejected with `40
 
 ## AI session limits
 
-AI features (like the AI Query Builder) that use urBackend's platform Groq key are capped per account, per calendar month:
+AI features that use urBackend's platform Groq key are capped per account, per calendar month. The AI Query Builder and the AI Collection Creator (Schema Design) each have their own separate monthly counter.
 
-| Plan | AI sessions per month (platform key) |
+### AI Query Builder
+
+| Plan | Query Builder requests per month (platform key) |
 | :--- | :--- |
 | Free | 5 |
 | Pro | 20 |
 
-Requests beyond the monthly cap return `403 Forbidden` until the counter resets on the first of the next calendar month (UTC).
+### AI Collection Creator (Schema Design)
+
+| Plan | Schema designs per month (platform key) |
+| :--- | :--- |
+| Free | 1 |
+| Pro | 5 |
+
+In addition to the monthly cap, each Collection Creator chat session using the platform key is limited to **20 iterations** (turns) before you must start a new session. This per-session cap protects platform resources against long, runaway conversations.
+
+Requests beyond either the monthly cap or the per-session iteration cap return `403 Forbidden`. Monthly counters reset on the first of the next calendar month (UTC).
 
-To bypass this cap, configure a personal Groq API key at the developer or project level. Requests that resolve to a BYOK key are not counted against the platform cap. See [BYOK for AI](/guides/ai-byok).
+To bypass both the monthly cap and the per-session iteration cap, configure a personal Groq API key at the developer or project level. Requests that resolve to a BYOK key are not counted against any platform cap. See [BYOK for AI](/guides/ai-byok).
 
 ## HTTP status codes