Error Handling

Every error includes a suggestion field — actionable instructions for agents and developers.

{
  "error": {
    "code": "FK_NOT_FOUND",
    "message": "Foreign key 'user_id' references row 'abc' which does not exist",
    "suggestion": "Create the referenced user first, then retry."
  }
}

HTTP status codes