API error codes

All 1221 error_code values the FeatherPanel API can return, with the HTTP status, the message and the controllers that send each one, read from the backend source.

Last synced from FeatherPanel 15b94e9 on 23 Oct 2026.

Error envelope

Errors come back in the standard envelope with success: false. Match on error_code, not on the message, which can change or be translated. See Rate limits and errors for the full shape.

{
  "success": false,
  "message": "...",
  "data": null,
  "error": true,
  "error_message": "...",
  "error_code": "SERVER_SUSPENDED",
  "errors": [{ "code": "SERVER_SUSPENDED", "detail": "...", "status": 403 }]
}

The list is collected from every ApiResponse::error() call with a literal code. Status and message are blank when the controller passes them in a variable. Codes built at runtime are not listed. A controller that asks for 502 gets 503, because ApiResponse never sends 502 (some proxies such as Cloudflare replace 502 bodies with an HTML page); the statuses below already show 503 for those.

Codes

1221 codes