1 files changed, 26 insertions, 3 deletions
diff --git a/lib/api/usage_data.rb b/lib/api/usage_data.rb
index 9e446aff605..3e2023d769f 100644
--- a/lib/api/usage_data.rb
+++ b/lib/api/usage_data.rb
@@ -12,11 +12,18 @@ module API
         forbidden!('Invalid CSRF token is provided') unless verified_request?
       end
 
-      desc 'Track usage data events' do
+      desc 'Track usage data event' do
         detail 'This feature was introduced in GitLab 13.4.'
+        success code: 200
+        failure [
+          { code: 403, message: 'Invalid CSRF token is provided' },
+          { code: 404, message: 'Not found' }
+        ]
+        tags %w[usage_data]
       end
       params do
-        requires :event, type: String, desc: 'The event name that should be tracked'
+        requires :event, type: String, desc: 'The event name that should be tracked',
+                         documentation: { example: 'i_quickactions_page' }
       end
       post 'increment_counter' do
         event_name = params[:event]
@@ -26,8 +33,17 @@ module API
         status :ok
       end
 
+      desc 'Track usage data event for the current user' do
+        success code: 200
+        failure [
+          { code: 403, message: 'Invalid CSRF token is provided' },
+          { code: 404, message: 'Not found' }
+        ]
+        tags %w[usage_data]
+      end
       params do
-        requires :event, type: String, desc: 'The event name that should be tracked'
+        requires :event, type: String, desc: 'The event name that should be tracked',
+                         documentation: { example: 'i_quickactions_page' }
       end
       post 'increment_unique_users', urgency: :low do
         event_name = params[:event]
@@ -39,6 +55,13 @@ module API
 
       desc 'Get a list of all metric definitions' do
         detail 'This feature was introduced in GitLab 13.11.'
+        success code: 200
+        failure [
+          { code: 403, message: 'Invalid CSRF token is provided' },
+          { code: 404, message: 'Not found' }
+        ]
+        produces ['application/yaml']
+        tags %w[usage_data metrics]
       end
       get 'metric_definitions', urgency: :low do
         content_type 'application/yaml'