From 036b93164773bab474956e8f03096708604da6a2 Mon Sep 17 00:00:00 2001
From: Kevin Strong-Holte <42565453+kstrongholte@users.noreply.github.com>
Date: Wed, 9 Aug 2023 12:55:03 -0700
Subject: [PATCH 1/3] Added context for `organization` parameter

---
 articles/api/authentication/_change-password.md | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/articles/api/authentication/_change-password.md b/articles/api/authentication/_change-password.md
index cdcb2fe15e..7f88a8b3eb 100644
--- a/articles/api/authentication/_change-password.md
+++ b/articles/api/authentication/_change-password.md
@@ -7,6 +7,7 @@ Content-Type: application/json
   "client_id": "${account.clientId}",
   "email": "EMAIL",
   "connection": "CONNECTION",
+  "organization": "ORGANIZATION_ID"
 }
 ```
 
@@ -14,7 +15,7 @@ Content-Type: application/json
 curl --request POST \
   --url https://${account.namespace}/dbconnections/change_password \
   --header 'content-type: application/json' \
-  --data '{"client_id": "${account.clientId}","email": "EMAIL", "connection": "CONNECTION"}'
+  --data '{"client_id": "${account.clientId}","email": "EMAIL", "connection": "CONNECTION", "organization": "ORGANIZATION_ID"}'
 ```
 
 ```javascript
@@ -28,7 +29,8 @@ curl --request POST \
   
   webAuth.changePassword({
     connection: 'CONNECTION',
-    email:   'EMAIL'
+    email:   'EMAIL',
+    organization: 'ORGANIZATION_ID'
   }, function (err, resp) {
     if(err){
       console.log(err.message);
@@ -52,9 +54,11 @@ curl --request POST \
 "We've just sent you an email to reset your password."
 ```
 
-Given a user's `email` address and a `connection`, Auth0 will send a change password email.
+Send a change password email to the user with the given email address on the given connection.
 
-This endpoint only works for database connections.
+Optionally, you may provide an Organization ID to support Organization-specific variables in customized email templates and redirect URLs.
+
+Note: This endpoint only works for database connections.
 
 ### Request Parameters
 
@@ -63,6 +67,7 @@ This endpoint only works for database connections.
 | `client_id` | The `client_id` of your client. We strongly recommend including a Client ID so that the email template knows from which client the request was triggered. |
 | `email` <br/><span class="label label-danger">Required</span> | The user's email address. |
 | `connection` <br/><span class="label label-danger">Required</span> | The name of the database connection configured to your client. |
+| `organization` | The `organization_id` of the Organization the user is a member of. |
 
 
 ### Remarks

From ef60953975b5487b6b28aad28d0db4c9152e2f32 Mon Sep 17 00:00:00 2001
From: Kevin Strong-Holte <42565453+kstrongholte@users.noreply.github.com>
Date: Fri, 11 Aug 2023 09:54:57 -0700
Subject: [PATCH 2/3] Clarified wording

---
 articles/api/authentication/_change-password.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/articles/api/authentication/_change-password.md b/articles/api/authentication/_change-password.md
index 7f88a8b3eb..75f1617e31 100644
--- a/articles/api/authentication/_change-password.md
+++ b/articles/api/authentication/_change-password.md
@@ -54,9 +54,9 @@ curl --request POST \
 "We've just sent you an email to reset your password."
 ```
 
-Send a change password email to the user with the given email address on the given connection.
+Send a change password email to the user's provided email address and `connection`.
 
-Optionally, you may provide an Organization ID to support Organization-specific variables in customized email templates and redirect URLs.
+Optionally, you may provide an Organization ID to support Organization-specific variables in [customized email templates](https://auth0.com/docs/customize/email/email-templates#common-variables) and to include the `organization_id` and `organization_name` parameters in the **Redirect To** URL.
 
 Note: This endpoint only works for database connections.
 

From a5174d53810f7f22fbd0f7ee56b19c245c077d97 Mon Sep 17 00:00:00 2001
From: Kevin Strong-Holte <42565453+kstrongholte@users.noreply.github.com>
Date: Fri, 11 Aug 2023 09:56:30 -0700
Subject: [PATCH 3/3] Clarified wording for "Organization" parameter table
 entry

---
 articles/api/authentication/_change-password.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/articles/api/authentication/_change-password.md b/articles/api/authentication/_change-password.md
index 75f1617e31..4f99e81283 100644
--- a/articles/api/authentication/_change-password.md
+++ b/articles/api/authentication/_change-password.md
@@ -67,7 +67,7 @@ Note: This endpoint only works for database connections.
 | `client_id` | The `client_id` of your client. We strongly recommend including a Client ID so that the email template knows from which client the request was triggered. |
 | `email` <br/><span class="label label-danger">Required</span> | The user's email address. |
 | `connection` <br/><span class="label label-danger">Required</span> | The name of the database connection configured to your client. |
-| `organization` | The `organization_id` of the Organization the user is a member of. |
+| `organization` | The `organization_id` of the Organization associated with the user. |
 
 
 ### Remarks