quota_exceeded

HTTP 402. The account has no allowance left. Nothing was rendered and nothing was billed.

402 — the keyless trial

{
  "error": {
    "type": "quota_exceeded",
    "message": "Trial limit reached: 50 renders.",
    "docs_url": "https://galleyrender.com/docs/errors/quota_exceeded",
    "details": {
      "trial": true,
      "limit": 50,
      "used": 50,
      "next_step": "Call the `create_account` tool with an email address to lift this limit, or sign up at https://galleyrender.com/signup. Templates and renders created during the trial are kept.",
      "pricing_url": "https://galleyrender.com/pricing"
    }
  }
}

402 — the free tier

{
  "error": {
    "type": "quota_exceeded",
    "message": "Free tier limit reached: 200 renders per month.",
    "docs_url": "https://galleyrender.com/docs/errors/quota_exceeded",
    "details": {
      "plan": "free",
      "limit": 200,
      "used": 200,
      "period": "2026-09",
      "resets_on": "2026-10-01",
      "upgrade_url": "https://galleyrender.com/pricing"
    }
  }
}

Why this happens

Two raise sites, both in the limit check that runs before any render work:

• Trial ceiling. A keyless trial has 50 billable units for the lifetime of the account, not per month, so waiting for the 1st does not help. details.trial is true.
• Free-tier allowance. A free plan account has 200 billable units per calendar month in UTC.

Units, not requests: one PNG is one unit, one PDF page is one unit. Cache hits and failed renders count for nothing.

How to fix it

On a trial, call the create_account MCP tool with an email and click the link. The ceiling is lifted on the same account, so your templates and renders survive — see Quickstart. On the free tier, upgrade, or wait for details.resets_on. Watch the balance with GET /v1/usage so this does not land in the middle of a batch.

Does retrying help?

Not immediately. Retry after details.resets_on, or after upgrading.