diff --git a/doc/api/repository_files.md b/doc/api/repository_files.md
index 49fb9bc141d..0623a6b02ae 100644
--- a/doc/api/repository_files.md
+++ b/doc/api/repository_files.md
@@ -90,6 +90,8 @@ Like [Get file from repository](repository_files.md#get-file-from-repository) yo
 
 ## Create new file in repository
 
+This allows you to create a single file. For creating multiple files with a single request see the [commits API](commits.html#create-a-commit-with-multiple-files-and-actions).
+
 ```
 POST /projects/:id/repository/files/:file_path
 ```
@@ -120,6 +122,8 @@ Parameters:
 
 ## Update existing file in repository
 
+This allows you to update a single file. For updating multiple files with a single request see the [commits API](commits.html#create-a-commit-with-multiple-files-and-actions).
+
 ```
 PUT /projects/:id/repository/files/:file_path
 ```
@@ -160,6 +164,8 @@ Currently gitlab-shell has a boolean return code, preventing GitLab from specify
 
 ## Delete existing file in repository
 
+This allows you to delete a single file. For deleting multiple files with a singleh request see the [commits API](commits.html#create-a-commit-with-multiple-files-and-actions).
+
 ```
 DELETE /projects/:id/repository/files/:file_path
 ```