402 quota_exceeded

Symptom

Publishing returns HTTP 402 with this body:

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly pin creation quota (1000) exceeded. Current usage: 1000.",
    "upgrade_url": "/v1/billing/checkout"
  }
}

Cause

Every plan includes a monthly pin quota, counted as successful publishes:

Plan	Monthly pins
Playground (Free)	50
Starter	300
Growth	1,000
Agency	5,000
Enterprise	Custom

quota_exceeded means you have used all of this month’s quota and credits do not apply (either credits are not enabled, or you are on a plan or trial that cannot use them). The quota resets on your monthly billing cycle.

If you have credits enabled but a zero balance, you will see credits_exhausted (also 402) instead, with upgrade_url pointing to the credit purchase endpoint.

How quota and credits work together

• Your monthly quota is consumed first, one per successful publish.
• Only after the monthly quota is exhausted does PinBridge debit 1 credit per pin, if credits are enabled.
• Free and trial workspaces cannot buy or use credits.

Fix

Choose one:

1. Wait for the monthly reset. Quota refreshes on your billing cycle.
2. Buy a credit pack (paid, non-trial plans only). Packs: Small 200 pins ($8), Medium 500 ($17.50), Large 1,500 ($45), XLarge 3,000 ($75). Credits are purchased through billing (upgrade_url on a credits_exhausted response points to the purchase endpoint). Note there is no SDK method for credits; buy them through the billing UI or API.
3. Upgrade your plan for a higher monthly quota. Follow the upgrade_url on the 402 response (/v1/billing/checkout). On Agency and Enterprise, upgrade_url is null; contact support to raise limits.

Related

• 403 plan_limit — a different limit (accounts, keys, features).
• Error reference — all 402 billing errors and the envelope shape.
• Troubleshooting — all articles.