1 files changed, 7 insertions, 2 deletions
diff --git a/lib/api/entities/deployment.rb b/lib/api/entities/deployment.rb
index 4e3a4c289d9..426e92e7723 100644
--- a/lib/api/entities/deployment.rb
+++ b/lib/api/entities/deployment.rb
@@ -3,11 +3,16 @@
 module API
   module Entities
     class Deployment < Grape::Entity
-      expose :id, :iid, :ref, :sha, :created_at, :updated_at
+      expose :id, documentation: { type: 'integer', example: 41 }
+      expose :iid, documentation: { type: 'integer', example: 1 }
+      expose :ref, documentation: { type: 'string', example: 'main' }
+      expose :sha, documentation: { type: 'string', example: '99d03678b90d914dbb1b109132516d71a4a03ea8' }
+      expose :created_at, documentation: { type: 'dateTime', example: '2016-08-11T11:32:35.444Z' }
+      expose :updated_at, documentation: { type: 'dateTime', example: '2016-08-11T11:32:35.444Z' }
       expose :user,        using: Entities::UserBasic
       expose :environment, using: Entities::EnvironmentBasic
       expose :deployable,  using: Entities::Ci::Job
-      expose :status
+      expose :status, documentation: { type: 'string', example: 'created' }
     end
   end
 end