v1

latestOpenAPI 3.0.02026-08-04891301.4 MB
auth

Request a magic link for login

Sends a magic link to the given email address so an existing user can sign in without a password. The user clicks the link in their email and is redirected to redirect_uri with a token; pass that token to /auth/verify_link to obtain session tokens.

If no account exists for the email, the endpoint still returns success to prevent email enumeration — no link is sent in that case. Both email and redirect_uri are required. Requests are rate-limited per IP (10 per minute) and per email-IP pair (3 per minute) — exceeding either limit returns HTTP 429. Returns HTTP 204 on success.

post/api/v1/auth/login/link

Request body

emailstring

Email address of the account to send the magic link to.

redirect_uristring

URL the user is redirected to after clicking the magic link. The token is appended as a query parameter.

Example request

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

Response

No content