Skip to main content

AdminResetPasswordDTO

Package: @nauth-toolkit/core Type: DTO (Request/Response)

Data transfer objects for admin-initiated password reset workflow. Sends verification code (and optional link) to user via email/SMS, allowing them to set their own password.

import { AdminResetPasswordDTO, AdminResetPasswordResponseDTO } from '@nauth-toolkit/nestjs';

AdminResetPasswordDTO (Request)

PropertyTypeRequiredDescription
baseUrlstringNoBase URL for building reset link. Valid URL with http:// or https://. Max 2048 chars.
codeExpiresInnumberNoCode expiry in seconds. Min 300 (5 min), max 86400 (24 hours). Default: 3600 (1 hour).
deliveryMethod'email' | 'sms'NoDelivery channel. Default: 'email'.
substringYesUser sub (UUID v4). Trimmed, lowercased for consistency.
reasonstringNoReason for admin-initiated reset (for audit trail). Max 500 chars. Trimmed.
revokeSessionsbooleanNoRevoke all active sessions immediately (before sending). Default: false.

AdminResetPasswordResponseDTO (Response)

PropertyTypeRequiredDescription
successbooleanYesAlways true on success.
deliveryMedium'email' | 'sms'NoDelivery medium used.
destinationstringNoMasked destination where code was sent.
expiresInnumberNoCode expiry in seconds.
sessionsRevokednumberNoNumber of sessions revoked (only present if revokeSessions was true).

Example

{
"sub": "a21b654c-2746-4168-acee-c175083a65cd",
"baseUrl": "https://myapp.com/reset-password",
"deliveryMethod": "email",
"revokeSessions": true,
"reason": "User reported account compromise"
}

Used By