funcodingdev
diff --git a/‎api/pkg/handlers/handler.go‎
Lines changed: 2 additions & 2 deletions b/‎api/pkg/handlers/handler.go‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎api/pkg/handlers/message_handler.go‎
Lines changed: 3 additions & 0 deletions b/‎api/pkg/handlers/message_handler.go‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎api/pkg/responses/response.go‎
Lines changed: 20 additions & 0 deletions b/‎api/pkg/responses/response.go‎
Lines changed: 20 additions & 0 deletions
@@ -9,11 +9,11 @@ import (
 // handler is the base struct for handling requests
 type handler struct{}
 
-func (h *handler) responseBadRequest(c *fiber.Ctx, payload any) error {
+func (h *handler) responseBadRequest(c *fiber.Ctx, err error) error {
 	return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{
 		"status":  "error",
 		"message": "The request isn't properly formed",
-		"data":    payload,
+		"data":    err,
 	})
 }
 
 
@@ -43,6 +43,9 @@ func NewMessageHandler(
 // @Accept       json
 // @Produce      json
 // @Success      200  {object}  responses.MessageResponse
+// @Success      400  {object}  responses.BadRequest
+// @Success      422  {object}  responses.UnprocessableEntity
+// @Success      500  {object}  responses.InternalServerError
 // @Router       /messages/send [post]
 func (h *MessageHandler) Send(c *fiber.Ctx) error {
 	ctx, span := h.tracer.StartFromFiberCtx(c)
 
@@ -4,3 +4,23 @@ type response struct {
 	Status  string `json:"status" example:"success"`
 	Message string `json:"message" example:"item created successfully"`
 }
+
+// InternalServerError is the response with status code is 500
+type InternalServerError struct {
+	Status  string `json:"status" example:"error"`
+	Message string `json:"message" example:"We ran into an internal error while handling the request."`
+}
+
+// BadRequest is the response with status code is 400
+type BadRequest struct {
+	Status  string `json:"status" example:"error"`
+	Message string `json:"message" example:"The request isn't properly formed"`
+	Data    string `json:"data" example:"The request body is not a valid JSON string"`
+}
+
+// UnprocessableEntity is the response with status code is 422
+type UnprocessableEntity struct {
+	Status  string              `json:"status" example:"error"`
+	Message string              `json:"message" example:"validation errors while sending message"`
+	Data    map[string][]string `json:"data"`
+}