1 files changed, 8 insertions, 2 deletions
diff --git a/lib/api/entities/push_event_payload.rb b/lib/api/entities/push_event_payload.rb
index 6aad5f10177..2d8f0d9344c 100644
--- a/lib/api/entities/push_event_payload.rb
+++ b/lib/api/entities/push_event_payload.rb
@@ -3,8 +3,14 @@
 module API
   module Entities
     class PushEventPayload < Grape::Entity
-      expose :commit_count, :action, :ref_type, :commit_from, :commit_to, :ref,
-             :commit_title, :ref_count
+      expose :commit_count, documentation: { type: 'integer', example: 1 }
+      expose :action, documentation: { type: 'string', example: 'pushed' }
+      expose :ref_type, documentation: { type: 'string', example: 'branch' }
+      expose :commit_from, documentation: { type: 'string', example: '50d4420237a9de7be1304607147aec22e4a14af7' }
+      expose :commit_to, documentation: { type: 'string', example: 'c5feabde2d8cd023215af4d2ceeb7a64839fc428' }
+      expose :ref, documentation: { type: 'string', example: 'master' }
+      expose :commit_title, documentation: { type: 'string', example: 'Add simple search to projects in public area' }
+      expose :ref_count, documentation: { type: 'integer', example: 1 }
     end
   end
 end