Plan Size Not Allowed

plan-size-not-allowed · 402

The account's plan doesn't run the size asked for, so the API made no change.

allowedSizeSlugs lists the sizes the plan runs. It answers a resize, a new web service given a size, or a new environment that copies a web service's size. The region's own list of sizes is checked first.

Besides the members every error carries, this type adds planKey, requestedSizeSlug and allowedSizeSlugs.

Common causes

  • The account's plan runs fewer sizes than the region sells, and one outside them was asked for.

How to fix the call

  • Pick a size from allowedSizeSlugs.
  • Or, if the user agrees, move to a plan that sells the size with ghaym cloud billing set-plan --plan <key>.

Example response

json
{
  "type": "plan-size-not-allowed",
  "title": "Plan Size Not Allowed",
  "detail": "The custom plan runs nano only, not 'micro'. Choose an allowed size, or move to a plan that sells the bigger ones.",
  "planKey": "custom",
  "requestedSizeSlug": "micro",
  "allowedSizeSlugs": [
    "nano"
  ],
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "method": "PATCH",
  "instance": "PATCH /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "status": 402,
  "docs": "https://ghaym.me/docs/errors/plan-size-not-allowed"
}