From d5d11e4dcfb6bd70ff2820fdc397f0e8afb7a55a Mon Sep 17 00:00:00 2001
From: Pavel Tisnovsky <ptisnovs@redhat.com>
Date: Mon, 6 Oct 2025 09:50:45 +0200
Subject: [PATCH 1/3] Field description in FeedbackResponse

---
 src/models/responses.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/models/responses.py b/src/models/responses.py
index 90be0cdc..5c2fde66 100644
--- a/src/models/responses.py
+++ b/src/models/responses.py
@@ -361,7 +361,11 @@ class FeedbackResponse(BaseModel):
         ```
     """
 
-    response: str
+    response: str = Field(
+        ...,
+        description="The response of the feedback request.",
+        examples=["feedback received"],
+    )
 
     # provides examples for /docs endpoint
     model_config = {

From d21155d146965eb58d2b1576492fee22e208c92c Mon Sep 17 00:00:00 2001
From: Pavel Tisnovsky <ptisnovs@redhat.com>
Date: Mon, 6 Oct 2025 09:53:58 +0200
Subject: [PATCH 2/3] Field description in StatusResponse

---
 src/models/responses.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/src/models/responses.py b/src/models/responses.py
index 5c2fde66..2c37d0f3 100644
--- a/src/models/responses.py
+++ b/src/models/responses.py
@@ -395,8 +395,17 @@ class StatusResponse(BaseModel):
         ```
     """
 
-    functionality: str
-    status: dict
+    functionality: str = Field(
+        ...,
+        description="The functionality of the service",
+        examples=["feedback"],
+    )
+
+    status: dict = Field(
+        ...,
+        description="The status of the service",
+        examples=[{"enabled": True}],
+    )
 
     # provides examples for /docs endpoint
     model_config = {

From b4e9bedbfda88802ac311955a0a4a314dbb90994 Mon Sep 17 00:00:00 2001
From: Pavel Tisnovsky <ptisnovs@redhat.com>
Date: Mon, 6 Oct 2025 09:57:22 +0200
Subject: [PATCH 3/3] Field description in ConversationResponse

---
 src/models/responses.py | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/src/models/responses.py b/src/models/responses.py
index 2c37d0f3..7345b189 100644
--- a/src/models/responses.py
+++ b/src/models/responses.py
@@ -520,8 +520,26 @@ class ConversationResponse(BaseModel):
         ```
     """
 
-    conversation_id: str
-    chat_history: list[dict[str, Any]]
+    conversation_id: str = Field(
+        ...,
+        description="Conversation ID (UUID)",
+        examples=["c5260aec-4d82-4370-9fdf-05cf908b3f16"],
+    )
+
+    chat_history: list[dict[str, Any]] = Field(
+        ...,
+        description="The simplified chat history as a list of conversation turns",
+        examples=[
+            {
+                "messages": [
+                    {"content": "Hello", "type": "user"},
+                    {"content": "Hi there!", "type": "assistant"},
+                ],
+                "started_at": "2024-01-01T00:01:00Z",
+                "completed_at": "2024-01-01T00:01:05Z",
+            }
+        ],
+    )
 
     # provides examples for /docs endpoint
     model_config = {