Bellwork
Allowance

Current rolling AI capacity

Returns a coarse state and a renewal date — deliberately never a balance, a count, or a percentage. Metered AI actions (chat, enrichment runs, and contact finds) draw against the trailing 168-hour allowance on the free tier. Each action returns exactly seven days after it was reserved; there is no calendar reset. Briefs are recorded but unmetered because follow slots already bound them. 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.

GET
/allowance

Returns a coarse state and a renewal date — deliberately never a balance, a count, or a percentage. Metered AI actions (chat, enrichment runs, and contact finds) draw against the trailing 168-hour allowance on the free tier. Each action returns exactly seven days after it was reserved; there is no calendar reset. Briefs are recorded but unmetered because follow slots already bound them. 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.

AuthorizationBearer <token>

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,
    "modules": {
      "internal": true,
      "enabled": [
        "string"
      ]
    }
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}