diff --git a/docs/api/role-management.asciidoc b/docs/api/role-management.asciidoc
index 6bc6f8f7af5b..73ebd62adbc5 100644
--- a/docs/api/role-management.asciidoc
+++ b/docs/api/role-management.asciidoc
@@ -6,7 +6,7 @@ experimental[This API is *experimental* and may be changed or removed completely
 
 The role management API allows people to manage roles that grant <<kibana-privileges>>.
 It is *not* supported to do so using the
-{ref}/security-api-roles.html[{es} Role Management APIs], and doing 
+{ref}/security-api.html#security-api-roles[{es} role management APIs], and doing 
 so will likely cause {kib}'s authorization to behave unexpectedly. 
 
 * <<role-management-api-put>>
diff --git a/docs/development/security/rbac.asciidoc b/docs/development/security/rbac.asciidoc
index 4d3180d211f0..43afb686ac5b 100644
--- a/docs/development/security/rbac.asciidoc
+++ b/docs/development/security/rbac.asciidoc
@@ -70,7 +70,7 @@ The application is created by concatenating the prefix of `kibana-` with the val
  }
 ----------------------------------
 
-Roles that grant <<kibana-privileges>> should be managed using the <<role-management-api>> or the *Management* / *Security* / *Roles* page, not directly using the {es} {ref}/security-api-roles.html[Role Management API]. This role can then be assigned to users using {es}'s {ref}/security-api-users.html[User Management APIs].
+Roles that grant <<kibana-privileges>> should be managed using the <<role-management-api>> or the *Management* / *Security* / *Roles* page, not directly using the {es} {ref}/security-api.html#security-api-roles[role management API]. This role can then be assigned to users using {es}'s {ref}/security-api-users.html[User Management APIs].
 
 [[development-rbac-authorization]]
 ==== Authorization
diff --git a/docs/security/index.asciidoc b/docs/security/index.asciidoc
index a6287e09107d..334b687459bc 100644
--- a/docs/security/index.asciidoc
+++ b/docs/security/index.asciidoc
@@ -29,8 +29,8 @@ see {xpack-ref}/authorization.html[Configuring Role-based Access Control].
 
 [NOTE]
 ============================================================================
-Managing roles that grant <<kibana-privileges>> using {es}'s {ref}
-/security-api-roles.html[Role Management APIs] is not supported. Doing so will likely
+Managing roles that grant <<kibana-privileges>> using the {es} 
+{ref}/security-api.html#security-api-roles[role management APIs] is not supported. Doing so will likely
 cause Kibana's authorization to behave unexpectedly.
 ============================================================================