Skip to main content
The Ruddr API uses standard HTTP status codes to indicate the success or failure of a request.

Status Codes

Success

CodeDescription
200 OKEverything worked as expected.
204 No ContentEverything worked as expected, but there is no content to return. Typical for delete requests.

Client Errors

CodeDescription
400 Bad RequestThe request was unacceptable due to an issue with the request format or data.
401 UnauthorizedThe API key is missing or invalid.
403 ForbiddenThe requested feature is not enabled for this workspace.
404 Not FoundThe resource or endpoint does not exist.
405 Method Not AllowedThe endpoint URL exists, but does not support the requested operation.
409 ConflictA resource with the same identifying information already exists, or the resource is read-only.
423 LockedAPI access is disabled for this workspace. Contact support for assistance.
429 Too Many RequestsRate limit exceeded. Slow down and retry after a delay.

Server Errors

CodeDescription
500 Internal Server ErrorSomething went wrong on Ruddr’s end.

Error Response Format

Error responses return a JSON object with a status code and descriptive message:
{
  "status": 400,
  "message": "Parameter 'id' is not a valid UUID."
}
Some validation errors may include an errors array with details:
{
  "status": 400,
  "message": "There was a problem processing your request. See errors for more details.",
  "errors": ["'name' is required"]
}