If you’ve ever been in the middle of a conversation with the NetDocuments AI Assistant and gotten a message saying you’ve run out of usage tokens, you’re not alone. You’ve hit the NetDocuments AI token limit, and the Assistant won’t answer again until it lifts.
Nothing Is Broken
Your conversation is still there. Your documents are fine. NetDocuments has paused AI for a while, and that’s all.
What’s Actually Happening?
Every time you use the AI Assistant, you spend tokens. Tokens are how AI measures text, and everything counts: your question, the documents you loaded, the conversation history, and the answer that comes back. (More on that in NetDocuments AI Assistant Frequently Asked Questions.)
Your firm has a monthly token allotment. Two limits sit on top of it:
- The 6-hour meter – NetDocuments breaks usage into 6-hour windows. That keeps the firm from burning through the month’s tokens in a week, and it keeps one user or one department from using up everyone else’s share. Hit the ceiling for the window and AI is paused until it resets.
- The monthly allotment – Token usage resets at the beginning of each month. Per NetDocuments, if your firm goes past its allotment, additional charges apply. What those charges are should have been laid out when your firm bought ndMAX.
This applies to the AI Assistant and to apps built with ndMAX (PatternBuilder MAX).
What Your Users Should Do
Wait a few minutes, then try again. If you’re being metered, you may already be near the end of the 6-hour window.
If you’ve been waiting more than an hour, stop retrying and tell your NetDocuments administrator.
How to Review Your Firm’s NetDocuments AI Token Usage
This part is for administrators. NetDocuments logs every AI action in the repository, and you can download the whole thing as a CSV.
Step 1: Open the Admin Console and Click AI Settings & Usage
It’s in the navigation panel. (This tab used to be called AI Models.)
Step 2: Click the Usage Tab
Step 3: Click Download Model Activity
Step 4: Pick the Quarter and Click Download Activity
The log downloads to your browser as a CSV file.
What to Look For in the Log
The log has a lot of columns. These are the ones that tell you where the tokens went:
- User – who ran it
- Input Tokens – what went in: the question, the documents, and the conversation history
- Output Tokens – what came back
- Source – whether it was an AI Assistant conversation or an app
- ThreadID – which conversation it belongs to
- FileAttachments – whether documents were attached
- AppName – which app was run, if it was an app
The quickest way to read it is a pivot table. Open the CSV in Excel, go to Insert → PivotTable, put User in Rows, and sum Input Tokens and Output Tokens in Values. Now you know who.
Then filter to your heaviest user and swap User for ThreadID. One thread with a long run of entries is a conversation that kept going long after it should have been restarted. Input tokens that dwarf output tokens mean a lot of documents went in to get short answers back.
How to Reduce Future Token Consumption
- Load only the documents you need – Select the three documents that matter, not the whole Workspace. Every document you load is input tokens.
- Ask focused questions – Name the document, the issue, and the answer you want back. Vague in, vague out, and you pay for both.
- Start a new thread when you change topics – The conversation history counts. A thread that started on a lease and drifted into an employment agreement is carrying the lease along with it.
- Break big reviews into sessions – For something like due diligence across hundreds of documents, plan the work in pieces rather than throwing everything at the Assistant at once.
- Talk to your heavy users – Not to scold them. Using AI is the point. It’s usually one habit that’s costing the firm, and it takes five minutes to fix.
- Connect Claude directly to NetDocuments – Per NetDocuments, MCP via ndConnect doesn’t consume your NetDocuments AI token allocation, because Claude uses its own model. It requires AI 300 (ndMAX Enterprise) and a Claude Team or Enterprise account. Here’s how to connect Claude to NetDocuments.
If your firm is still running out every month after all of that, you’ve outgrown your allotment. Talk to your NetDocuments account manager.
Need Help?
Running out of AI tokens and not sure who’s using them or why? We can pull your usage log, find where the tokens are going, and train your attorneys on prompting that doesn’t waste them — usually in a single call.
Schedule a free consultation at go.oncehub.com/optconsult.
Craig Bayer is the founder and leader of Optiable, an award-winning document management (DMS) consulting firm dedicated to helping law firms seamlessly integrate NetDocuments. Specializing in firms with 10 to 150 users, he has rolled out NetDocuments for over 600 law firms across the United States and Canada since 2010.
CONNECT WITH CRAIG → linkedin.com/in/craigbayer

