1 files changed, 6 insertions, 1 deletions
diff --git a/lib/api/entities/ci/job_artifact.rb b/lib/api/entities/ci/job_artifact.rb
index 9e504aee383..8276c0f4073 100644
--- a/lib/api/entities/ci/job_artifact.rb
+++ b/lib/api/entities/ci/job_artifact.rb
@@ -4,7 +4,12 @@ module API
   module Entities
     module Ci
       class JobArtifact < Grape::Entity
-        expose :file_type, :size, :filename, :file_format
+        expose :file_type,
+          documentation: { type: 'string', values: ::Ci::JobArtifact.file_types.keys, example: 'archive' }
+        expose :size, documentation: { type: 'integer', example: 1000 }
+        expose :filename, documentation: { type: 'string', example: 'artifacts.zip' }
+        expose :file_format,
+          documentation: { type: 'string', values: ::Ci::JobArtifact.file_formats.keys, example: 'zip' }
       end
     end
   end