diff --git a/doc/api/README.md b/doc/api/README.md
index 8c4f1b9c885..e12070dc1ce 100644
--- a/doc/api/README.md
+++ b/doc/api/README.md
@@ -43,6 +43,7 @@ following locations:
 - [Tags](tags.md)
 - [Todos](todos.md)
 - [Users](users.md)
+- [Validate CI configuration](ci/lint.md)
 
 ### Internal CI API
 
@@ -50,7 +51,6 @@ The following documentation is for the [internal CI API](ci/README.md):
 
 - [Builds](ci/builds.md)
 - [Runners](ci/runners.md)
-- [Validate the .gitlab-ci.yaml](ci/ci_lint.md)
 
 ## Authentication
 
diff --git a/doc/api/ci/README.md b/doc/api/ci/README.md
index 8439598a5a8..96a281e27c8 100644
--- a/doc/api/ci/README.md
+++ b/doc/api/ci/README.md
@@ -22,4 +22,3 @@ GET /ci/api/v1/builds/:id/artifacts
 
 - [Builds](builds.md)
 - [Runners](runners.md)
-- [Validate the .gitlab-ci.yaml](ci_lint.md)
diff --git a/doc/api/ci/ci_lint.md b/doc/api/ci/lint.md
similarity index 95%
rename from doc/api/ci/ci_lint.md
rename to doc/api/ci/lint.md
index 2b169176dd6..876ee508474 100644
--- a/doc/api/ci/ci_lint.md
+++ b/doc/api/ci/lint.md
@@ -1,4 +1,4 @@
-# Validate the .gitlab-ci.yaml
+# Validate the .gitlab-ci.yml
 
 Check whether your .gitlab-ci.yml file is valid.