v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

auth

Request a magic link for registration

Starts a passwordless registration flow by sending a verification link to the given email address. The recipient clicks the link and is redirected to redirect_uri with a token; pass that token to /auth/verify_link to complete registration and obtain session tokens.

Profile fields (full_name, alias, timezone) are captured now and applied when the link is verified. 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/register/link

Request body

aliasstring

Display alias (handle) for the new account.

emailstring

Email address to send the registration magic link to.

full_namestring

Full name for the new account.

redirect_uristring

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

timezonestring

IANA timezone name for the new account, e.g. "America/New_York".

Example request

{
  "alias": "string",
  "email": "user@example.com",
  "full_name": "Example Name",
  "redirect_uri": "https://example.com",
  "timezone": "America/New_York"
}

Response

No content