Errors, Rate Limits & Status Codes

Deskbolic uses conventional HTTP response codes to indicate the success or failure of an API request.

HTTP Status Codes

Code	Meaning	Description
200 OK	Success	Request completed successfully.
201 Created	Resource Created	New record created successfully.
400 Bad Request	Invalid Request	Malformed parameters or body.
401 Unauthorized	Authentication Required	Missing or invalid API key/JWT.
402 Payment Required	Subscription Inactive	Account subscription limit reached or expired.
403 Forbidden	Access Denied	Permission denied or API channel feature not enabled.
404 Not Found	Not Found	The requested resource does not exist.
422 Unprocessable	Validation Error	Validation failed on resource attributes.
500 Server Error	Internal Error	Server encountered an error.

Error Response Format

{
  "errors": [
    {
      "code": "not_found",
      "message": "Resource not found"
    }
  ]
}