1 files changed, 13 insertions, 1 deletions
diff --git a/lib/api/container_registry_event.rb b/lib/api/container_registry_event.rb
index 66689f8d7c8..9acf2fca1b3 100644
--- a/lib/api/container_registry_event.rb
+++ b/lib/api/container_registry_event.rb
@@ -23,8 +23,20 @@ module API
       content_type :json, DOCKER_DISTRIBUTION_EVENTS_V1_JSON
       format :json
 
+      desc 'Receives notifications from the container registry when an operation occurs' do
+        detail 'This feature was introduced in GitLab 12.10'
+        consumes [:json, DOCKER_DISTRIBUTION_EVENTS_V1_JSON]
+      end
       params do
-        requires :events, type: Array
+        requires :events, type: Array, desc: 'Event notifications' do
+          requires :action, type: String, desc: 'The action to perform, `push`, `delete`',
+                            values: %w[push delete].freeze
+          optional :target, type: Hash, desc: 'The target of the action' do
+            optional :tag, type: String, desc: 'The target tag'
+            optional :repository, type: String, desc: 'The target repository'
+            optional :digest, type: String, desc: 'Unique identifier for target image manifest'
+          end
+        end
       end
 
       # This endpoint is used by Docker Registry to push a set of event