diff --git a/api-ref/source/v3/application-credentials.inc b/api-ref/source/v3/application-credentials.inc
index bb3ab0c857..5a89071f34 100644
--- a/api-ref/source/v3/application-credentials.inc
+++ b/api-ref/source/v3/application-credentials.inc
@@ -98,8 +98,8 @@ Create application credential
 
 .. rest_method::  POST /v3/users/{user_id}/application_credentials
 
-Creates an application credential for a user on the project to which they are
-currently scoped.
+Creates an application credential for a user on the project to which the
+current token is scoped.
 
 Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/application_credentials``
 
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 980e987b21..51a1bc9800 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -1531,9 +1531,10 @@ request_application_credential_name_body_required:
   type: string
 request_application_credential_roles_body_not_required:
   description: |
-    An optional list of role objects, identified by ID or name. If not
-    provided, the roles assigned to the application credential will be the
-    same as the roles in the current token.
+    An optional list of role objects, identified by ID or name. The list
+    may only contain roles that the user has assigned on the project.
+    If not provided, the roles assigned to the application credential will
+    be the same as the roles in the current token.
   in: body
   required: false
   type: array