Sign in

v1

latestOpenAPI 3.0.32026-07-26172157253.6 KB
Client

Send email verification (code or link based on config)

Send email verification using the method configured in auth settings (verifyEmailMethod). When method is 'code', sends a 6-digit numeric code. When method is 'link', sends a browser verification link that goes through an InsForge backend endpoint first. Prevents user enumeration by returning success even if email doesn't exist.

post/api/auth/email/send-verification

Request body

emailstring email required
redirectTostring uri

Used for link-based email verification. The email link always opens an InsForge backend endpoint first; after the token is verified, InsForge redirects the browser to this URL. This URL must be included in allowedRedirectUrls. Recommended: use your app's sign-in page.

Example request

{
  "email": "user@example.com"
}

Response

Verification email sent (if email exists). Message varies based on configured method.

successboolean
messagestring

Example response

{
  "message": "If your email is registered, we have sent you a verification code/link. Please check your inbox."
}