1 files changed, 11 insertions, 5 deletions
diff --git a/lib/api/entities/hook.rb b/lib/api/entities/hook.rb
index 95924321221..e24e201ac57 100644
--- a/lib/api/entities/hook.rb
+++ b/lib/api/entities/hook.rb
@@ -3,12 +3,18 @@
 module API
   module Entities
     class Hook < Grape::Entity
-      expose :id, :url, :created_at, :push_events, :tag_push_events, :merge_requests_events, :repository_update_events
-      expose :enable_ssl_verification
+      expose :id, documentation: { type: 'string', example: 1 }
+      expose :url, documentation: { type: 'string', example: 'https://webhook.site' }
+      expose :created_at, documentation: { type: 'dateTime', example: '2012-05-28T04:42:42-07:00' }
+      expose :push_events, documentation: { type: 'boolean' }
+      expose :tag_push_events, documentation: { type: 'boolean' }
+      expose :merge_requests_events, documentation: { type: 'boolean' }
+      expose :repository_update_events, documentation: { type: 'boolean' }
+      expose :enable_ssl_verification, documentation: { type: 'boolean' }
 
-      expose :alert_status
-      expose :disabled_until
-      expose :url_variables
+      expose :alert_status, documentation: { type: 'symbol', example: :executable }
+      expose :disabled_until, documentation: { type: 'dateTime', example: '2012-05-28T04:42:42-07:00' }
+      expose :url_variables, documentation: { type: 'Hash', example: { "token" => "secr3t" }, is_array: true }
 
       def url_variables
         object.url_variables.keys.map { { key: _1 } }