1 files changed, 16 insertions, 6 deletions
diff --git a/lib/api/package_files.rb b/lib/api/package_files.rb
index 278dc4c2044..bb9f96cdbb1 100644
--- a/lib/api/package_files.rb
+++ b/lib/api/package_files.rb
@@ -8,19 +8,23 @@ module API
       authorize_packages_access!(user_project)
     end
 
+    PACKAGE_FILES_TAGS = %w[package_files].freeze
+
     feature_category :package_registry
     urgency :low
 
     helpers ::API::Helpers::PackagesHelpers
 
     params do
-      requires :id, type: String, desc: 'The ID of a project'
-      requires :package_id, type: Integer, desc: 'The ID of a package'
+      requires :id, types: [String, Integer], desc: 'ID or URL-encoded path of the project'
+      requires :package_id, type: Integer, desc: 'ID of a package'
     end
     resource :projects, requirements: API::NAMESPACE_OR_PROJECT_REQUIREMENTS do
-      desc 'Get all package files' do
-        detail 'This feature was introduced in GitLab 11.8'
+      desc 'List package files' do
+        detail 'Get a list of package files of a single package'
         success ::API::Entities::PackageFile
+        is_array true
+        tags PACKAGE_FILES_TAGS
       end
       params do
         use :pagination
@@ -35,11 +39,17 @@ module API
         present paginate(package_files), with: ::API::Entities::PackageFile
       end
 
-      desc 'Remove a package file' do
+      desc 'Delete a package file' do
         detail 'This feature was introduced in GitLab 13.12'
+        success code: 204
+        failure [
+          { code: 403, message: 'Forbidden' },
+          { code: 404, message: 'Not found' }
+        ]
+        tags PACKAGE_FILES_TAGS
       end
       params do
-        requires :package_file_id, type: Integer, desc: 'The ID of a package file'
+        requires :package_file_id, type: Integer, desc: 'ID of a package file'
       end
       delete ':id/packages/:package_id/package_files/:package_file_id' do
         authorize_destroy_package!(user_project)