Response envelope

Success responses share this shape:

{
  "success": true,
  "message": "Human-readable summary",
  "data": { /* endpoint-specific payload */ }
}

Error responses:

{
  "success": false,
  "message": "What went wrong",
  "errors": { /* optional structured detail — present on validation & some 4xx */ }
}

data / errors may be omitted when there is none. Always branch on the HTTP
status code and success, not on message text.

Modified at 2026-06-23 08:45:10