> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quotamint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Diagnose authentication, denial, retry, and delivery failures

## `401 invalid_api_key`

Check that:

* The bearer header is present and has no extra quotes.
* The key is complete and was copied from the one-time creation response.
* The key has not been revoked.
* `qm_test_` is used for test traffic and `qm_live_` for production.

## `200 allowed: false`

This is a product decision, not a transport failure. Inspect `reason`:

* `no_active_plan`: assign a plan to the customer.
* `feature_not_entitled`: update the plan entitlement.
* `insufficient_credits`: top up credits, or show an upgrade path.
* `customer_inactive`: restore the customer according to your billing state.

## `409 idempotency_key_reused`

The key was already used with a different payload, endpoint, or environment. Log the operation ID and payload hash in your own system. Use the existing result if the original operation is the one you intended; otherwise choose a new key for a new operation.

## `429 rate_limited`

Honor `Retry-After`. Reduce concurrency per key or distribute independent services across keys where that matches your security model. Do not retry in a tight loop.

## `429 workspace_usage_limit_exceeded`

The workspace's monthly account allowance is full. Upgrade the account plan or wait for the next period; retrying the same request cannot bypass the allowance.

## `503 service_unavailable`

The runtime could not complete the decision within its budget, or a dependency is temporarily unavailable. The outcome of the operation is unknown: retry a `consume` with the same idempotency key. Contact support with the returned `requestId` if it persists.