From ca2915bc75425932aa64748377a1da66794cd6b8 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 28 Aug 2025 16:24:40 +0000
Subject: [PATCH 1/2] Add documentation about AI assistant credits

---
 ai/assistant-credits.mdx | 52 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 ai/assistant-credits.mdx

diff --git a/ai/assistant-credits.mdx b/ai/assistant-credits.mdx
new file mode 100644
index 000000000..3452ae0bc
--- /dev/null
+++ b/ai/assistant-credits.mdx
@@ -0,0 +1,52 @@
+# AI Assistant Credits
+
+AI assistant credits are the billing units used to measure usage of Mintlify's AI-powered features. This page explains how credits work, where they're used, and how to track your usage.
+
+## What is a Credit?
+
+**1 credit = 1 AI message**
+
+Credits are consumed each time the AI assistant generates a response to a user query. The billing is straightforward:
+
+- Ask 1 question → Use 1 credit
+- Ask 2 questions → Use 2 credits
+- Ask 10 questions → Use 10 credits
+
+Each interaction with the AI assistant, regardless of the complexity or length of the response, counts as one credit.
+
+## Where Credits Are Used
+
+AI assistant credits are consumed across three main areas of the Mintlify platform:
+
+### Docs Side Panel
+The most common usage of credits occurs through the AI assistant in your documentation's side panel. When users interact with the AI assistant while browsing your docs, each question they ask consumes one credit from your account.
+
+### Slack Bot
+If you've integrated Mintlify's AI assistant with your Slack workspace, each message sent to the bot will use one credit. This includes questions asked in direct messages or mentions in channels.
+
+### Assistant API
+When using Mintlify's Assistant API to integrate AI functionality into your own applications, each API call that generates an AI response will consume one credit.
+
+## Tracking Credit Usage
+
+You can monitor your credit consumption and remaining balance through your Mintlify dashboard. This helps you:
+
+- Track usage patterns across different features
+- Monitor credit consumption over time
+- Plan for future billing cycles
+- Identify which features are driving the most usage
+
+## Credit Limits and Billing
+
+Credit limits and billing details depend on your Mintlify plan. For specific information about:
+
+- Monthly credit allowances
+- Overage pricing
+- Plan upgrades
+- Billing cycles
+
+Please refer to your account dashboard or contact the Mintlify team for detailed pricing information specific to your plan.
+
+<Note>
+Credits are consumed in real-time as users interact with the AI assistant. Make sure to monitor your usage regularly to avoid unexpected overages.
+</Note>
\ No newline at end of file

From 556b93fc5d671b7d49ad7ff0e5ef5fd38816c52c Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 28 Aug 2025 16:24:48 +0000
Subject: [PATCH 2/2] Updated docs.json

---
 docs.json | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs.json b/docs.json
index a137f89a6..574fdc78a 100644
--- a/docs.json
+++ b/docs.json
@@ -49,7 +49,8 @@
               "guides/claude-code",
               "guides/cursor",
               "guides/windsurf",
-              "ai/slack-app"
+              "ai/slack-app",
+              "ai/assistant-credits"
             ]
           },
           {
@@ -516,4 +517,4 @@
       "publicApiKey": "pk_76a6caa274e800f3ceff0b2bc6b9b9d82ab8"
     }
   }
-}
+}
\ No newline at end of file