Usage & Quotas
This is about entitlement quota — what your Site's Plan allows. It is a completely separate mechanism from rate limiting; see that page for the distinction.
Read your Site's current entitlements
GET /api/v1/account/sites/{siteId}/entitlements
Requires account.manage. Returns your Site's currently assigned Plan (or null if none is
assigned — that's a legitimate, honest state, not an error) plus the materialized entitlement rows
for that Plan.
Each entitlement row includes:
| Field | Meaning |
|---|---|
capabilityKey |
Which capability this row governs (e.g. reading the feed). |
isAllowed |
Whether this capability is included at all. |
quotaLimit |
The numeric ceiling for this period, or null if unlimited. |
usedCount |
How much has been used so far this period, or null if not tracked. |
periodStart |
When the current counting period began. |
period |
The period unit (e.g. daily). |
Denied is not the same as zero. If isAllowed is false, the capability isn't included at
all — don't infer this from quotaLimit/usedCount being small or absent.
AI usage
GET /api/v1/ai-usage
Requires ai.usage.read. Read-only, diagnostic visibility into your Site's own AI content
generation status — never entitlement-charged by calling it. Returns generation status counts,
today's usage, and the shared platform-wide AI budget state (explicitly labeled as
platform-wide — it is never a per-Site allocation).
AI image usage
GET /api/v1/ai-images
Requires ai.images.read. Similar to ai-usage, but for AI-generated/enhanced images, which are
platform-wide (not per-Site) by design.
What quota numbers mean
Quota values come entirely from whatever Plan your Customer has. There is no universal published number — read your own entitlements to see what actually applies to your Site.