Errors

SysOS uses conventional HTTP status codes. 2xx indicates success, 4xx a problem with the request, and 5xx an error on our side.

Status	Meaning
`200`	OK — request succeeded.
`201`	Created — resource was created.
`204`	No Content — succeeded with no body.
`400`	Bad Request — malformed or missing fields.
`401`	Unauthorized — missing or invalid token.
`403`	Forbidden — token lacks the required scope.
`404`	Not Found — resource does not exist.
`409`	Conflict — duplicate or state conflict.
`429`	Too Many Requests — rate limited.

Errors carry a machine-readable code and a human message:

{
  "error": {
    "code": "invalid_request",
    "message": "Field 'email' is required."
  }
}