diff --git a/docs/docs/apis/actions/complement-token.md b/docs/docs/apis/actions/complement-token.md
index 92a11f0cb..70004d8a8 100644
--- a/docs/docs/apis/actions/complement-token.md
+++ b/docs/docs/apis/actions/complement-token.md
@@ -17,7 +17,7 @@ This trigger is called before userinfo are set in the token or response.
     - `getUser()` [*User*](./objects#user)
     - `user`
       - `getMetadata()` [*metadataResult*](./objects#metadata-result)
-    - `grants` [*UserGrantList*](./objects#user-grant-list)
+      - `grants` [*UserGrantList*](./objects#user-grant-list)
 - `api`  
   The second parameter contains the following fields:
   - `v1`
@@ -45,7 +45,7 @@ This trigger is called before the claims are set in the access token and the tok
     - `getUser()` [*User*](./objects#user)
     - `user`
       - `getMetadata()` [*metadataResult*](./objects#metadata-result)
-    - `grants` [*UserGrantList*](./objects#user-grant-list)
+      - `grants` [*UserGrantList*](./objects#user-grant-list)
 - `api`  
   The second parameter contains the following fields:
   - `v1`
diff --git a/docs/docs/apis/actions/external-authentication.md b/docs/docs/apis/actions/external-authentication.md
index 2bf9eb09f..294a99cad 100644
--- a/docs/docs/apis/actions/external-authentication.md
+++ b/docs/docs/apis/actions/external-authentication.md
@@ -13,13 +13,13 @@ A user has authenticated externally. ZITADEL retrieved and mapped the external i
 - `ctx`  
 The first parameter contains the following fields
   - `accessToken` *string*  
-    The access token which will be returned to the user. This can be an opaque token or a JWT
+    The access token returned by the identity provider. This can be an opaque token or a JWT
   - `claimsJSON()` [*idTokenClaims*](../openidoauth/claims)  
     Returns all claims of the id token
   - `getClaim(key)` *Any*  
     Returns the requested [id token claim](../openidoauth/claims)
   - `idToken` *string*  
-    The id token which will be returned to the user
+    The id token provided by the identity provider.
   - `v1`
     - `externalUser()` [*externalUser*](./objects#external-user)
     - `authError` *string*