1 files changed, 45 insertions, 4 deletions

diff --git a/lib/api/rubygem_packages.rb b/lib/api/rubygem_packages.rb
index 87cf1f66223..af0ceb1acfc 100644
--- a/lib/api/rubygem_packages.rb
+++ b/lib/api/rubygem_packages.rb
@@ -28,19 +28,27 @@ module API
     before do
       require_packages_enabled!
       authenticate_non_get!
+    end
+
+    after_validation do
       not_found! unless Feature.enabled?(:rubygem_packages, user_project)
     end
 
     params do
-      requires :id, type: String, desc: 'The ID or full path of a project'
+      requires :id, types: [Integer, String], desc: 'The ID or URL-encoded path of the project'
     end
     resource :projects, requirements: API::NAMESPACE_OR_PROJECT_REQUIREMENTS do
       namespace ':id/packages/rubygems' do
         desc 'Download the spec index file' do
           detail 'This feature was introduced in GitLab 13.9'
+          failure [
+            { code: 401, message: 'Unauthorized' },
+            { code: 404, message: 'Not Found' }
+          ]
+          tags %w[rubygem_packages]
         end
         params do
-          requires :file_name, type: String, desc: 'Spec file name'
+          requires :file_name, type: String, desc: 'Spec file name', documentation: { type: 'file' }
         end
         get ":file_name", requirements: FILE_NAME_REQUIREMENTS do
           # To be implemented in https://gitlab.com/gitlab-org/gitlab/-/issues/299267
@@ -49,9 +57,14 @@ module API
 
         desc 'Download the gemspec file' do
           detail 'This feature was introduced in GitLab 13.9'
+          failure [
+            { code: 401, message: 'Unauthorized' },
+            { code: 404, message: 'Not Found' }
+          ]
+          tags %w[rubygem_packages]
         end
         params do
-          requires :file_name, type: String, desc: 'Gemspec file name'
+          requires :file_name, type: String, desc: 'Gemspec file name', documentation: { type: 'file' }
         end
         get "quick/Marshal.#{MARSHAL_VERSION}/:file_name", requirements: FILE_NAME_REQUIREMENTS do
           # To be implemented in https://gitlab.com/gitlab-org/gitlab/-/issues/299284
@@ -60,9 +73,16 @@ module API
 
         desc 'Download the .gem package' do
           detail 'This feature was introduced in GitLab 13.9'
+          success code: 200
+          failure [
+            { code: 401, message: 'Unauthorized' },
+            { code: 403, message: 'Forbidden' },
+            { code: 404, message: 'Not Found' }
+          ]
+          tags %w[rubygem_packages]
         end
         params do
-          requires :file_name, type: String, desc: 'Package file name'
+          requires :file_name, type: String, desc: 'Package file name', documentation: { type: 'file' }
         end
         get "gems/:file_name", requirements: FILE_NAME_REQUIREMENTS do
           authorize_read_package!(user_project)
@@ -80,6 +100,12 @@ module API
         namespace 'api/v1' do
           desc 'Authorize a gem upload from workhorse' do
             detail 'This feature was introduced in GitLab 13.9'
+            success code: 200
+            failure [
+              { code: 401, message: 'Unauthorized' },
+              { code: 403, message: 'Forbidden' }
+            ]
+            tags %w[rubygem_packages]
           end
           post 'gems/authorize' do
             authorize_workhorse!(
@@ -91,6 +117,13 @@ module API
 
           desc 'Upload a gem' do
             detail 'This feature was introduced in GitLab 13.9'
+            success code: 201
+            failure [
+              { code: 401, message: 'Unauthorized' },
+              { code: 403, message: 'Forbidden' },
+              { code: 404, message: 'Not Found' }
+            ]
+            tags %w[rubygem_packages]
           end
           params do
             requires :file, type: ::API::Validations::Types::WorkhorseFile, desc: 'The package file to be published (generated by Multipart middleware)', documentation: { type: 'file' }
@@ -133,6 +166,14 @@ module API
 
           desc 'Fetch a list of dependencies' do
             detail 'This feature was introduced in GitLab 13.9'
+            success code: 200
+            failure [
+              { code: 401, message: 'Unauthorized' },
+              { code: 403, message: 'Forbidden' },
+              { code: 404, message: 'Not Found' }
+            ]
+            is_array true
+            tags %w[rubygem_packages]
           end
           params do
             optional :gems, type: Array[String], coerce_with: ::API::Validations::Types::CommaSeparatedToArray.coerce, desc: 'Comma delimited gem names'