Error handling

All errors follow a consistent format for easy handling.

Error response format

{
  "error": "Error message",
  "details": []
}

• details is optional and typically used for validation errors.

HTTP status codes

• 200 Success

• 400 Bad Request (validation error)

• 401 Unauthorized (missing/invalid JWT)

• 403 Forbidden (not allowed)

• 404 Not Found

• 429 Too Many Requests (rate limit exceeded)

• 500 Internal Server Error

Example errors

Validation error

{
  "error": "Validation error",
  "details": [
    {
      "path": ["name"],
      "message": "String must contain at least 1 character(s)"
    }
  ]
}

Authentication error

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

Not found

{
  "error": "Token not found"
}