How much AI capacity is left this week
Returns a coarse state and a renewal date — deliberately never a balance, a count, or a percentage. AI actions (chat, enrichment runs, briefs, contact finds) draw against a weekly allowance on the free tier; enterprise and internal are unmetered and report `metered: false`. Clients should show nothing while `comfortable`, a quiet notice at `low`, and the upgrade path at `exhausted`. Requests refused for want of allowance return 402 from the acting endpoint, not from here.
Returns a coarse state and a renewal date — deliberately never a balance, a count, or a percentage. AI actions (chat, enrichment runs, briefs, contact finds) draw against a weekly allowance on the free tier; enterprise and internal are unmetered and report metered: false. Clients should show nothing while comfortable, a quiet notice at low, and the upgrade path at exhausted. Requests refused for want of allowance return 402 from the acting endpoint, not from here.
API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/allowance"{
"data": {
"state": "comfortable",
"renews_at": "2019-08-24T14:15:22Z",
"metered": true
}
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}MCP Integration
Using Bellwork with AI assistants via Model Context Protocol
Book one chat action against the caller's org POST
Records a single chat action on the AI spend ledger. Takes no body: the kind is fixed and the org comes from auth, so a caller can only add spend to themselves. Exists for the eve chat channel, which cannot reach the ledger in-process; not intended for general API use.