Skip to content

Request a sign-in or reset link

POST
/v1/auth/otp/request
curl --request POST \
--url http://localhost:8080/v1/auth/otp/request \
--header 'Content-Type: application/json' \
--data '{ "email": "example", "purpose": "example" }'

Anonymous, rate-limited per address. Emails a single-use link for purpose login (default) or reset, valid for auth.otp_ttl_minutes. Always answers 202 whether or not the address belongs to an active account, so it cannot be used to enumerate users. 422 when email-link sign-in is disabled by policy and the purpose is login.

Media typeapplication/json
object
email
string
purpose

Login | reset

string
Examplegenerated
{
"email": "example",
"purpose": "example"
}

Accepted