Layerbeat
Guides

Errors

Errors always have this shape; `request_id` helps us investigate if you contact support.

Errors always have this shape; request_id helps us investigate if you contact support.

{"error": {"code": "insufficient_balance", "message": "Wallet balance is lower than the order total.",
           "request_id": "req-123", "details": {"required": "12.00", "available": "0.00", "currency": "USD"}}}
HTTPcodeMeaning
400invalid_requestThe request is malformed or a value is invalid. The message says which
401unauthorizedMissing, invalid, expired or revoked token
401invalid_credentialsWrong email or password (the two are indistinguishable on purpose)
402insufficient_balanceYour wallet cannot cover the price. details has required and available
403forbiddenAuthenticated but not allowed: missing scope, role too low, or session-only endpoint
404not_foundNo such resource in your organization
405method_not_allowedWrong HTTP method for this path
409invalid_stateThe server is in the wrong state for this action (for example start while running)
409out_of_stockThe plan is out of stock in that region right now
409quota_exceededA capacity or account limit was reached (provider capacity, 20 API keys, 100 firewall rules)
409quote_expiredThe quote is older than 10 minutes: request a new one
409idempotency_conflictThe Idempotency-Key was already used with a different request
409conflictThe change conflicts with existing data (duplicate email, SSH key, member or firewall rule; last owner)
429rate_limitedToo many requests: wait Retry-After seconds
500internalSomething went wrong on our side. Retry; contact support with the request_id if it persists
503funding_unavailableFunding verification or hosted checkout is temporarily unavailable
503purchases_pausedNew VPS purchases are temporarily disabled; no credit is reserved
503provider_unavailableOur infrastructure provider is temporarily unavailable. Retry shortly