From 7da82df24dc709f4b37d49037ea9ccae6d181721 Mon Sep 17 00:00:00 2001
From: Ralph Slooten <axllent@gmail.com>
Date: Fri, 19 Jun 2026 21:45:42 +1200
Subject: [PATCH] Fix: Update Swagger response definitions for
 MessageHeadersResponse (#703)

---
 server/apiv1/swaggerResponses.go |  2 +-
 server/ui/api/v1/swagger.json    | 31 ++++++++++++++-----------------
 2 files changed, 15 insertions(+), 18 deletions(-)

diff --git a/server/apiv1/swaggerResponses.go b/server/apiv1/swaggerResponses.go
index 274653d..fa9cdfb 100644
--- a/server/apiv1/swaggerResponses.go
+++ b/server/apiv1/swaggerResponses.go
@@ -117,7 +117,7 @@ type chaosResponse struct {
 }
 
 // Message headers
-// swagger:model MessageHeadersResponse
+// swagger:response MessageHeadersResponse
 type messageHeadersResponse map[string][]string
 
 // Summary of messages
diff --git a/server/ui/api/v1/swagger.json b/server/ui/api/v1/swagger.json
index 581c311..d9b11aa 100644
--- a/server/ui/api/v1/swagger.json
+++ b/server/ui/api/v1/swagger.json
@@ -174,10 +174,7 @@
         ],
         "responses": {
           "200": {
-            "description": "MessageHeadersResponse",
-            "schema": {
-              "$ref": "#/definitions/MessageHeadersResponse"
-            }
+            "$ref": "#/responses/MessageHeadersResponse"
           },
           "400": {
             "$ref": "#/responses/ErrorResponse"
@@ -1774,18 +1771,6 @@
       },
       "x-go-package": "github.com/axllent/mailpit/internal/storage"
     },
-    "MessageHeadersResponse": {
-      "description": "Message headers",
-      "type": "object",
-      "additionalProperties": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        }
-      },
-      "x-go-name": "messageHeadersResponse",
-      "x-go-package": "github.com/axllent/mailpit/server/apiv1"
-    },
     "MessageSummary": {
       "description": "MessageSummary struct for frontend messages",
       "type": "object",
@@ -1875,7 +1860,7 @@
       "type": "object",
       "properties": {
         "messages": {
-          "description": "Messages summary\nin: body",
+          "description": "Messages summary",
           "type": "array",
           "items": {
             "$ref": "#/definitions/MessageSummary"
@@ -2025,6 +2010,18 @@
         }
       }
     },
+    "MessageHeadersResponse": {
+      "description": "Message headers",
+      "schema": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "MessagesSummaryResponse": {
       "description": "Summary of messages",
       "schema": {