subscription_required (403)

← Error reference

subscription_required

HTTP status: 403

Retryable: No — retrying without changes will fail the same way.

The org is not entitled: it has no active subscription (post-trial or lapsed).

When it fires

A request hit a billing-gated endpoint while the org is not entitled — its trial window has expired with no subscription, its subscription is `canceled`, or it is `past_due` beyond the dunning grace window. Any leftover credits are frozen, not spendable, until the org re-subscribes (billing credit-wallet MVP design §5).

How to handle it

Start or renew a subscription from the console, then retry. Frozen credits become spendable again once the subscription is active. Retrying without re-subscribing will produce the same response.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/subscription_required",
    "code": "subscription_required",
    "message": "Subscription required. Re-subscribe to continue.",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/subscription_required"
  }
}