Overview

Errors

The Sentinel API uses standard HTTP status codes to indicate the success or failure of requests.

HTTP Status Codes

Code Status Description
200 OK Request succeeded
201 Created Resource created successfully
204 No Content Resource deleted successfully
400 Bad Request Invalid request syntax or parameters
401 Unauthorized Missing or invalid API token
403 Forbidden Access denied to this resource
404 Not Found Resource does not exist
422 Unprocessable Entity Validation errors in request body
429 Too Many Requests Rate limit exceeded
500 Server Error Internal server error

Error Response Format

Error responses include a message and optional validation errors:

{
  "message": "The given data was invalid.",
  "errors": {
    "url": [
      "The url field is required."
    ],
    "check_interval": [
      "The check interval must be between 1 and 60."
    ]
  }
}

Authentication Error

{
  "message": "Unauthenticated."
}

Authorization Error

{
  "message": "This action is unauthorized."
}