1 files changed, 10 insertions, 3 deletions
diff --git a/lib/api/entities/ci/job.rb b/lib/api/entities/ci/job.rb
index cf87684ce55..d9e6b7eed75 100644
--- a/lib/api/entities/ci/job.rb
+++ b/lib/api/entities/ci/job.rb
@@ -6,10 +6,17 @@ module API
       class Job < JobBasic
         # artifacts_file is included in job_artifacts, but kept for backward compatibility (remove in api/v5)
         expose :artifacts_file, using: ::API::Entities::Ci::JobArtifactFile, if: -> (job, opts) { job.artifacts? }
-        expose :job_artifacts, as: :artifacts, using: ::API::Entities::Ci::JobArtifact
+        expose :job_artifacts, as: :artifacts,
+                               using: ::API::Entities::Ci::JobArtifact,
+                               documentation: { is_array: true }
         expose :runner, with: ::API::Entities::Ci::Runner
-        expose :artifacts_expire_at
-        expose :tag_list do |job|
+        expose :artifacts_expire_at,
+          documentation: { type: 'dateTime', example: '2016-01-19T09:05:50.355Z' }
+
+        expose(
+          :tag_list,
+          documentation: { type: 'string', is_array: true, example: ['ubuntu18', 'docker runner'] }
+        ) do |job|
           job.tags.map(&:name).sort
         end
       end