This guide explains how Curated meters and bills usage, and how admins can monitor and control credit consumption across an organization.
For: workspace admins Time to read: ~10 minutes
How credits work
Every prompt run against Curated consumes credits. Credits cover compute (the model time spent answering), data access (any paid data sources or premium layers your question touches), and artifact generation (PDF rendering, image generation, voice synthesis).
Credits are pooled at the organization level, not per-user. A heavy user and a light user on the same plan average out.
What costs how much
Approximate credit costs as of v2.x (exact numbers shown in the usage dashboard at run time):
| Operation | Approx credits | |---|---| | Text prompt with one layer | 1–3 | | Multi-agent query (e.g. GIS + Salesforce together) | 3–8 | | PlaceStory generation | 5–10 | | PDF report (1–3 pages) | 8–15 | | PDF report (5+ pages with images and citations) | 15–40 | | Marketing post bundle (3 platforms + images) | 10–25 | | Vertical playbook output (e.g. Active-Wellness) | 30–80 | | Voice mode | same as text + ~1 credit per minute of audio |
Curated shows the projected credit cost before any operation likely to exceed 10 credits, so users don't get surprised.
The usage dashboard
Settings → Usage shows admin-facing usage data. Three views:
Current cycle
- Total credits used this billing month
- Projected burn rate — straight-line projection of where you'll land at month-end
- Days remaining in the current cycle
- Days until reset if you're already over
Breakdown
- By agent — which capabilities are driving usage (GIS Agent vs PlaceStory vs Marketing Agent vs Playbook Agent)
- By user — top consumers, with drill-down into their last 100 prompts
- By Space — which projects are consuming credits
Historical
- Last 12 months of usage, by month, with month-over-month change
Managing credits
Setting a baseline
Your plan ships with a baseline monthly credit allowance. Most teams find this is sufficient for the first 60–90 days; usage grows as more team members adopt Curated.
If you're consistently going over, talk to your account contact — there are options:
- Upgrade plan — higher monthly baseline
- Add a credit pack — one-time top-up that doesn't reset
- Configure per-user credit caps — prevent any single user from consuming the entire pool
Admin credit overrides
For one-off cases (e.g. an analyst running a big quarterly study), admins can grant extra credits to a specific user without changing the org plan.
Settings → Users → click a user → Credit override
- Set an additional credit allowance for the current cycle
- The override is capped by your org pool (you can't grant more credits than your org has)
- Override expires at the next cycle reset unless renewed
Overrides are logged in the audit log so credit-grant decisions are traceable.
Suspension for non-payment
If invoices go unpaid past their grace period, the workspace enters suspended state:
- Existing conversations remain visible (read-only)
- No new prompts can be run
- Admins receive daily emails until payment is received
- Customer data is preserved indefinitely while suspended (we don't delete on suspension)
Resolution: pay the outstanding invoice. Access restores within ~10 minutes.
Billing cycles
Cycles start on a configurable anniversary day per organization (default: 1st of the month). At cycle reset:
- The credit pool refills to your plan's monthly allowance
- Unused credits do not roll over by default (this is a plan-level setting; rollover is available on annual plans)
- One-time credit packs do roll over until consumed
- A new invoice is generated for the prior month
Invoices are emailed to the billing contact set in Settings → Billing → Billing contact. By default this is the workspace creator; update it for ongoing AP routing.
Common scenarios
"Our budget owner needs visibility before approval." Set them up with a Viewer role and give them access to the Usage dashboard. They can see consumption without being able to run prompts.
"Our compliance team needs a per-user audit." The Usage dashboard exports per-user usage as CSV. Combined with the Audit log export (Settings → Audit log), you have full traceability.
"We're running a one-week intensive study." Talk to your account contact about a temporary credit boost. Quicker than negotiating a plan change and reverts automatically.
"A user has burned 80% of our pool." Set a per-user credit cap to prevent recurrence: Settings → Users → click user → Per-cycle cap.
Related
- Managing Workspace Access
- Security
- Terms of Service