API Errors

Error Response Format

{
  "error": {
    "code": "error_code",
    "message": "Human readable message",
    "details": {
      "field": "Additional context"
    }
  }
}

HTTP Status Codes

Code	Description
200	Success
201	Created
204	No Content
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
409	Conflict
422	Unprocessable Entity
429	Rate Limit Exceeded
500	Internal Server Error

Common Errors

authentication_failed

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid or expired API key"
  }
}

validation_error

{
  "error": {
    "code": "validation_error",
    "message": "Validation failed",
    "details": {
      "name": "Name is required",
      "url": "Invalid URL format"
    }
  }
}

not_found

{
  "error": {
    "code": "not_found",
    "message": "Service 'xyz' not found"
  }
}

conflict

{
  "error": {
    "code": "conflict",
    "message": "Service with this name already exists"
  }
}