1 files changed, 6 insertions, 6 deletions
diff --git a/lib/api/entities/resource_milestone_event.rb b/lib/api/entities/resource_milestone_event.rb
index 26dc6620cbe..b301f5b7d0a 100644
--- a/lib/api/entities/resource_milestone_event.rb
+++ b/lib/api/entities/resource_milestone_event.rb
@@ -3,18 +3,18 @@
 module API
   module Entities
     class ResourceMilestoneEvent < Grape::Entity
-      expose :id
+      expose :id, documentation: { type: 'integer', example: 142 }
       expose :user, using: Entities::UserBasic
-      expose :created_at
-      expose :resource_type do |event, _options|
+      expose :created_at, documentation: { type: 'dateTime', example: '2018-08-20T13:38:20.077Z' }
+      expose :resource_type, documentation: { type: 'string', example: 'Issue' } do |event, _options|
         event.issuable.class.name
       end
-      expose :resource_id do |event, _options|
+      expose :resource_id, documentation: { type: 'integer', example: 253 } do |event, _options|
         event.issuable.id
       end
       expose :milestone, using: Entities::Milestone
-      expose :action
-      expose :state
+      expose :action, documentation: { type: 'string', example: 'add' }
+      expose :state, documentation: { type: 'string', example: 'active' }
     end
   end
 end