v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

auth

Request a magic link for login or registration

Sends a passwordless magic link to the given email address. If an account with that email already exists, a login link is sent. If no account exists, a registration link is sent and the recipient completes sign-up by clicking through. This unified endpoint lets you implement a single email-entry UI that handles both cases transparently.

The redirect_uri is validated against the app's registered hosts; an unregistered URI returns HTTP 400. Both email and redirect_uri are required. Requests are rate-limited per IP (10 per minute) and per email-IP pair (3 per minute). Returns HTTP 204 on success — no body.

post/api/v1/auth/request/link

Request body

emailstring

Email address to send the magic link to.

redirect_uristring

URL the user is redirected to after clicking the magic link. Must be registered with the app.

Example request

{
  "email": "user@example.com",
  "redirect_uri": "https://example.com"
}

Response

No content