Documentation / API Response Format / Validation Errors

Validation Errors

Validation Errors for hostingctl API clients.

The inspected read endpoints do not perform heavy body validation. For planned write endpoints, validation errors should use 422 and include field-level error information.

Success

{
  "success": true,
  "message": "hostingctl API resource loaded.",
  "data": {
    "resource": "domains",
    "items": []
  },
  "timestamp": "2026-06-19T00:00:00+00:00"
}

Error

{
  "success": false,
  "message": "Invalid or expired API token.",
  "errors": [],
  "timestamp": "2026-06-19T00:00:00+00:00"
}

Client Notes

  • Check the HTTP status code first.
  • Then inspect success.
  • Do not assume items exists on every endpoint.
  • Log message values for operator review, but never log tokens.
← Error Responses Empty Results →