diff --git a/docs/swagger.yaml b/docs/swagger.yaml
index 7abc789fc8..4865f3cc63 100644
--- a/docs/swagger.yaml
+++ b/docs/swagger.yaml
@@ -3031,7 +3031,9 @@ paths:
           description: The chart name
       responses:
         '200':
-          $ref: '#/definitions/ChartVersions'
+          description: Retrieved all versions of the specified chart
+          schema:
+            $ref: '#/definitions/ChartVersions'
         '401':
           $ref: '#/definitions/UnauthorizedChartAPIError'
         '403':
@@ -3091,7 +3093,9 @@ paths:
           description: The chart version
       responses:
         '200':
-          $ref: '#/definitions/ChartVersionDetails'
+          description: Successfully retrieved the chart version
+          schema:
+            $ref: '#/definitions/ChartVersionDetails'
         '401':
           $ref: '#/definitions/UnauthorizedChartAPIError'
         '403':