1 files changed, 10 insertions, 4 deletions
diff --git a/lib/api/entities/ci/variable.rb b/lib/api/entities/ci/variable.rb
index f4d5248245a..47597cb77be 100644
--- a/lib/api/entities/ci/variable.rb
+++ b/lib/api/entities/ci/variable.rb
@@ -4,10 +4,16 @@ module API
   module Entities
     module Ci
       class Variable < Grape::Entity
-        expose :variable_type, :key, :value
-        expose :protected?, as: :protected, if: -> (entity, _) { entity.respond_to?(:protected?) }
-        expose :masked?, as: :masked, if: -> (entity, _) { entity.respond_to?(:masked?) }
-        expose :environment_scope, if: -> (entity, _) { entity.respond_to?(:environment_scope) }
+        expose :variable_type, documentation: { type: 'string', example: 'env_var' }
+        expose :key, documentation: { type: 'string', example: 'TEST_VARIABLE_1' }
+        expose :value, documentation: { type: 'string', example: 'TEST_1' }
+        expose :protected?, as: :protected, if: -> (entity, _) { entity.respond_to?(:protected?) },
+                            documentation: { type: 'boolean' }
+        expose :masked?, as: :masked, if: -> (entity, _) { entity.respond_to?(:masked?) },
+                         documentation: { type: 'boolean' }
+        expose :raw?, as: :raw, if: -> (entity, _) { entity.respond_to?(:raw?) }, documentation: { type: 'boolean' }
+        expose :environment_scope, if: -> (entity, _) { entity.respond_to?(:environment_scope) },
+                                   documentation: { type: 'string', example: '*' }
       end
     end
   end