Multi-tenancy authentication API reference - discovery email reset start

Email reset start

POSThttps://test.stytch.com/v1/b2b/passwords/discovery/email/reset/start

Initiates a password reset for the email address provided, when cross-org passwords are enabled. This will trigger an email to be sent to the address, containing a magic link that will allow them to set a new password and authenticate.

This endpoint adapts to your Project's password strength configuration. If you're using zxcvbn, the default, your passwords are considered valid if the strength score is >= 3. If you're using LUDS, your passwords are considered valid if they meet the requirements that you've set with Stytch. You may update your password strength configuration in the stytch dashboard.

Body parameters

email_address* string

reset_password_redirect_url string

discovery_redirect_url string

reset_password_template_id string

locale string

reset_password_expiration_minutes int

code_challenge string

locale string

Response fields

request_id string

status_code int

curl --request POST \
  --url https://test.stytch.com/v1/b2b/passwords/discovery/email/reset/start \
  -u 'PROJECT_ID:SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "email_address": "sandbox@stytch.com"
  }'

RESPONSE

{
  "status_code": 200,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
  "member_email_id": "member-email-test-1dd089b3-8904-47ef-b943-987968e549d4",
  "member": {...}
}