asyavee/medusa-store
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: add more clarification to reset password in API reference (#11695)

Browse Source
This commit is contained in:
Shahed Nasser
2025-03-03 18:09:03 +02:00
committed by GitHub
parent 92514885e4
commit 40a9cffb34
11 changed files with 58 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
www/apps/api-reference/specs/admin/paths/auth_user_{auth_provider}_reset-password.yaml
View File

@@ -3,13 +3,23 @@ post:
summary: Generate Reset Password Token for Admin User
x-sidebar-summary: Generate Reset Password Token
description: >
Generate a reset password token for an admin user. This API route emits the
`` event, passing it the token as a payload. You can listen to that event
and send the user a notification. The notification should have a URL that
accepts a `token` query parameter.
Generate a reset password token for an admin user. This API route doesn't
reset the admin's password or send them the reset instructions in a
notification.
Use the generated token to update the user's password using the Reset Password API route.
Instead, This API route emits the `auth.password_reset` event, passing it
the token as a payload. You can listen to that event in a subscriber as
explained in [this
guide](https://docs.medusajs.com/resources/commerce-modules/auth/reset-password),
then send the user a notification. The notification is sent using a
[Notification Module
Provider](https://docs.medusajs.com/resources/architectural-modules/notification),
and it should have the URL to reset the password in the Medusa Admin
dashboard, such as `http://localhost:9000/app/reset-password?token=123`.
Use the generated token to update the user's password using the [Reset Password API route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerupdate).
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#generate-reset-password-token-route

5
www/apps/api-reference/specs/admin/paths/auth_user_{auth_provider}_update.yaml
View File

@@ -3,8 +3,9 @@ post:
summary: Reset an Admin User's Password
x-sidebar-summary: Reset Password
description: >-
Reset a user's password. Generate the reset password token first using the
Get Reset Password Token API route.
Reset an admin user's password using a reset-password token generated with
the [Generate Reset Password Token API
route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerresetpassword).
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#reset-password-route