Skip to main content

​
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.