1 files changed, 10 insertions, 9 deletions
diff --git a/app/serializers/test_suite_entity.rb b/app/serializers/test_suite_entity.rb
index 15eb2891b22..a31b1f3ab9b 100644
--- a/app/serializers/test_suite_entity.rb
+++ b/app/serializers/test_suite_entity.rb
@@ -1,18 +1,19 @@
 # frozen_string_literal: true
 
 class TestSuiteEntity < Grape::Entity
-  expose :name
-  expose :total_time
-  expose :total_count
+  expose :name, documentation: { type: 'string', example: 'test' }
+  expose :total_time, documentation: { type: 'integer', example: 1904 }
+  expose :total_count, documentation: { type: 'integer', example: 3363 }
 
-  expose :success_count
-  expose :failed_count
-  expose :skipped_count
-  expose :error_count
+  expose :success_count, documentation: { type: 'integer', example: 3351 }
+  expose :failed_count, documentation: { type: 'integer', example: 0 }
+  expose :skipped_count, documentation: { type: 'integer', example: 12 }
+  expose :error_count, documentation: { type: 'integer', example: 0 }
 
   with_options if: -> (_, opts) { opts[:details] } do |test_suite|
-    expose :suite_error
-    expose :test_cases, using: TestCaseEntity do |test_suite|
+    expose :suite_error,
+      documentation: { type: 'string', example: 'JUnit XML parsing failed: 1:1: FATAL: Document is empty' }
+    expose :test_cases, using: TestCaseEntity, documentation: { is_array: true } do |test_suite|
       test_suite.suite_error ? [] : test_suite.sorted.test_cases.values.flat_map(&:values)
     end
   end